Fs.open/Mode:Read - Revision history

Oeed: Categorised page

2014-03-25T09:42:36Z

Categorised page

Lyqyd at 21:37, 30 December 2012

2012-12-30T21:37:48Z

Lyqyd: Initial rough entry.

2012-12-19T17:01:27Z

Initial rough entry.

New page

== Opening A File For Reading ==

To read data from a saved file, one must use either of the read modes with [[fs.open]](). The two read modes are textual read mode ("r") and binary read mode ("rb"). Most work with reading data from files in ComputerCraft will be done with textual read mode.

All examples below will use a file at the path "file/name", which contains this text:

<pre>line 1
line 2
a third line</pre>

== Textual Read Mode ==

{{Function
|name=<var>handle</var>.readLine
|api=fs
|returns=[[string]] the next line read from the file, with the end-of-line character stripped; or nil if there are no more lines in the file
|desc=Reads the next line from the file
}}

<pre>
local handle = fs.open("file/name", "r")
if handle then
text = handle.readLine()
--text now contains: line 1
text = handle.readLine()
--text now contains: line 2
text = handle.readLine()
--text now contains: a third line
handle.close()
end
</pre>

← Older revision		Revision as of 09:42, 25 March 2014
Line 29:		Line 29:
	</pre>		</pre>
	}}		}}
		+
		+	[[Category:Lua_Core_Functions]]

@@ Line 16: / Line 16: @@
 |returns=[[string]] the next line read from the file, with the end-of-line character stripped; or nil if there are no more lines in the file
 |desc=Reads the next line from the file
-}}
+|examples=<pre>
-−
 <pre>
 local handle = fs.open("file/name", "r")
 if handle then
@@ Line 30: / Line 28: @@
 end
 </pre>