OptIstreamIter is a class for iterating over arguments that come from an input stream. Each line of the input stream is considered to be a set of white-space separated tokens. If the the first non-white character on a line is '#' ('!' for VMS systems) then the line is considered a comment and is ignored.
- Note
- If a line is more than 1022 characters in length then we treat it as if it were several lines of length 1022 or less.
-
The string tokens returned by this iterator are pointers to temporary buffers which may not necessarily stick around for too long after the call to curr() or operator(), hence if you need the string value to persist - you will need to make a copy.