Iterates through the lines of a file by using
struct lines ;
The line terminator (
'\n' by default) is part of the string read (it
could be missing in the last line of the file). Several types are
line, and the behavior of
dstring, a new string of the respective type is allocated every read.
dchar, the line's content will be reused (overwritten) across reads.
immutable(ubyte), the behavior is similar to case (1), except that no UTF checking is attempted upon input.
ubyte, the behavior is similar to case (2), except that no UTF checking is attempted upon input.
In all cases, a two-symbols versions is also accepted, in which case
the first symbol (of integral type, e.g.
uint) tracks the zero-based number of the current line.
In case of an I/O error, an
StdioException is thrown.