Difference between revisions of "Io"

From GiderosMobile
Line 19: Line 19:
 
end</source>
 
end</source>
 
{|-
 
{|-
| style="width: 50%;"|
+
| style="width: 50%; vertical-align:top;"|
 
=== Methods ===
 
=== Methods ===
[[io.close]] {{<translate>closes file, or the default output file</translate>}}<br/>
+
[[io.close]] ''<translate>closes file, or the default output file</translate>''<br/>
[[io.flush]] {{<translate>flushes the default output file</translate>}}<br/>
+
[[io.flush]] ''<translate>flushes the default output file</translate>''<br/>
[[io.input]] {{<translate>opens file in text mode, sets as default input file, or returns current default input file</translate>}}<br/>
+
[[io.input]] ''<translate>opens file in text mode, sets as default input file, or returns current default input file</translate>''<br/>
[[io.lines]] {{<translate>open file in read mode, returns iterator function to return lines, nil ends</translate>}}<br/>
+
[[io.lines]] ''<translate>open file in read mode, returns iterator function to return lines, nil ends</translate>''<br/>
[[io.open]] {{<translate>opens file in specified mode "[rawb ]", returns handle or nil</translate>}}<br/>
+
[[io.open]] ''<translate>opens file in specified mode "[rawb ]", returns handle or nil</translate>''<br/>
[[io.output]] {{<translate>opens file in text mode, sets as default output file, or returns current default output file</translate>}}<br/>
+
[[io.output]] ''<translate>opens file in text mode, sets as default output file, or returns current default output file</translate>''<br/>
[[io.read]] {{<translate>reads file according to given formats, returns read values or nil</translate>}}<br/>
+
[[io.read]] ''<translate>reads file according to given formats, returns read values or nil</translate>''<br/>
[[io.tmpfile]] {{<translate>returns a handle for a temporary file, opened in update mode</translate>}}<br/>
+
[[io.tmpfile]] ''<translate>returns a handle for a temporary file, opened in update mode</translate>''<br/>
[[io.type]] {{<translate>returns "file" if obj is an open file handle, "close file" if closed, or nil if not a file handle</translate>}}<br/>
+
[[io.type]] ''<translate>returns "file" if obj is an open file handle, "close file" if closed, or nil if not a file handle</translate>''<br/>
[[io.write]] {{<translate>writes strings or numbers to file</translate>}}<br/>
+
[[io.write]] ''<translate>writes strings or numbers to file</translate>''<br/>
| style="width: 50%;"|
+
| style="width: 50%; vertical-align:top;"|
 
=== Events ===
 
=== Events ===
 
=== Constants ===
 
=== Constants ===
 
|}
 
|}

Revision as of 14:30, 23 August 2018

Supported platforms: android, ios, mac, pc
Available since: Gideros 2011.6

Description

Manages main input/output operations

Examples

Copy a file

local function copy(src, dst)
	local srcf = io.open(src, "rb")
	local dstf = io.open(dst, "wb")
	local size = 2^13      -- good buffer size (8K)
	while true do
		local block = srcf:read(size)
		if not block then break end
		dstf:write(block)
	end
	srcf:close()
	dstf:close()
end

Methods

io.close closes file, or the default output file
io.flush flushes the default output file
io.input opens file in text mode, sets as default input file, or returns current default input file
io.lines open file in read mode, returns iterator function to return lines, nil ends
io.open opens file in specified mode "[rawb ]", returns handle or nil
io.output opens file in text mode, sets as default output file, or returns current default output file
io.read reads file according to given formats, returns read values or nil
io.tmpfile returns a handle for a temporary file, opened in update mode
io.type returns "file" if obj is an open file handle, "close file" if closed, or nil if not a file handle
io.write writes strings or numbers to file

Events

Constants