View source for Fs.open/Mode:Read

== 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
|examples=<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>
}}