io.output
Lua function

io.output

Summary

Opens a file for output

Prototype

f = io.output (filename



Description

Opens filename for output in text mode. Raises an error if it cannot.

If opened OK returns a handle to the opened file, and makes it the default output file.

If called with no argument, returns the handle to the default output file.

If called with a file handle, sets the default output file to that handle.


f = io.output ("test.txt") --> handle to new file
f:write ("some data here") -- write to it
f:close ()  -- close that file now



See Also ...

Topics

DOC_lua_base Lua base functions
DOC_lua_bc Lua bc (big number) functions
DOC_lua_bit Lua bit manipulation functions
DOC_lua_coroutines Lua coroutine functions
DOC_lua_debug Lua debug functions
DOC_lua_io Lua io functions
DOC_lua_math Lua math functions
DOC_lua_os Lua os functions
DOC_lua_package Lua package functions
DOC_lua_rex Lua PCRE regular expression functions
DOC_lua Lua script extensions
DOC_lua_string Lua string functions
DOC_lua_tables Lua table functions
DOC_lua_utils Lua utilities
DOC_scripting Scripting

Lua functions

LUA_f:close f:close (Closes a file)
LUA_f:flush f:flush (Flushes outstanding data to disk)
LUA_f:lines f:lines (Returns an iterator function for reading the file line-by-line)
LUA_f:read f:read (Reads the file according to the specified formats)
LUA_f:seek f:seek (Sets and gets the current file position)
LUA_f:setvbuf f:setvbuf (Sets the buffering mode for an output file)
LUA_f:write f:write (Writes to a file)
LUA_io.close io.close (Closes a file)
LUA_io.flush io.flush (Flushes outstanding data to disk for the default output file)
LUA_io.input io.input (Opens filename for input in text mode)
LUA_io.lines io.lines (Returns an iterator function for reading a named file line-by-line)
LUA_io.open io.open (Opens a file)
LUA_io.popen io.popen (Creates a pipe and executes a command)
LUA_io.read io.read (Reads from the default input file)
LUA_io.stderr io.stderr (File handle for standard error file)
LUA_io.stdin io.stdin (File handle for standard input file)
LUA_io.stdout io.stdout (File handle for standard output file)
LUA_io.tmpfile io.tmpfile (Returns a handle to a temporary file)
LUA_io.type io.type (Returns type of file handle)
LUA_io.write io.write (Writes to the default output file)

(Help topic: lua=io.output)

DOC_contents Documentation contents page