diff options
author | Reinhard Tartler <siretart@tauware.de> | 2009-03-31 15:58:19 +0200 |
---|---|---|
committer | Reinhard Tartler <siretart@tauware.de> | 2009-03-31 15:58:19 +0200 |
commit | 25db897553a0db0f912602b375029e724f51556e (patch) | |
tree | 613c8c23e22481e31a4d2f474e022ad87728da24 /docs/common/lib_common/IOStreamGetLine.txt | |
parent | 2787035d98661881477d696403ca2a78b49322d5 (diff) |
Import upstream version 0.11~rc2+r2072
Diffstat (limited to 'docs/common/lib_common/IOStreamGetLine.txt')
-rw-r--r-- | docs/common/lib_common/IOStreamGetLine.txt | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/common/lib_common/IOStreamGetLine.txt b/docs/common/lib_common/IOStreamGetLine.txt new file mode 100644 index 00000000..04c56b57 --- /dev/null +++ b/docs/common/lib_common/IOStreamGetLine.txt @@ -0,0 +1,29 @@ +CLASS IOStreamGetLine + +This class provides a convenient way to read text from a file, line by line. It also can preprocess the line to remove leading and trailing whitespace and comments. Comments are started by the character # and run to the end of the line. + +Create an instance by passing a reference to a stream into the constructor. + +Note the class does internal buffering, so you can only detach it later if the stream supports seeking backwards. + + +FUNCTION IOStreamGetLine::GetLine() + +Returns true if a line could be retreieved without a read timing out. + + +FUNCTION IOStreamGetLine::IsEOF() + +Whether the end of the stream has been reached. Do not call GetLine if this is true. + + +FUNCTION IOStreamGetLine::GetLineNumber() + +Returns the line number. + + +FUNCTION IOStreamGetLine::DetachFile() + +Detaches the stream from the GetLine class. Will seek backwards to "replace" data it's buffered back in the stream. + + |