nik/lush
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Correction in the documentation of 'io.lines'

Browse Source 
The loop does not end on end of file, but when the iterator function
fails to read a value. (In particular, the format "a" never fails,
so a loop with 'io.lines(fname, "a")' never ends.)
This commit is contained in:
Roberto Ierusalimschy
2019-07-31 11:41:59 -03:00
parent fe040633a1
commit 223bb04090
2 changed files with 5 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
manual/manual.of
View File

@@ -7926,8 +7926,8 @@ instead of returning an error code.
Opens the given file name in read mode
and returns an iterator function that
works like @T{file:lines(@Cdots)} over the opened file.
When the iterator function detects the end of file,
it returns no values (to finish the loop) and automatically closes the file.
When the iterator function fails to read any value,
it automatically closes the file.
Besides the iterator function,
@id{io.lines} returns three other values:
two @nil values as placeholders,
@@ -7941,7 +7941,8 @@ to @T{io.input():lines("l")};
that is, it iterates over the lines of the default input file.
In this case, the iterator does not close the file when the loop ends.
In case of errors this function raises the error,
In case of errors opening the file,
this function raises the error,
instead of returning an error code.
}
@@ -8053,9 +8054,6 @@ starting at the current position.
Unlike @Lid{io.lines}, this function does not close the file
when the loop ends.
In case of errors this function raises the error,
instead of returning an error code.
}
@LibEntry{file:read (@Cdots)|