read-line-into!

Reads a line of elements from a stream into a collection.

Reads in a line of elements from the stream starting from the the stream’s current position and places those elements into sequenceSequence must be mutable to allow it to expand should the streamed in elements be larger than its original size when grow?: is #t.  Handles end-of-stream conditions just as read-element does.

The end of line may be ‘\r’, ‘\n’, or ‘\r\n’.

Exported from

Modifiers

open

Arguments

streamAn instance of <stream>.
stringAn instance of <string>.  This sequence must allow for changes in its size when grow?: is #t.
start:An instance of <integer>.  What index to start writing into the sequence.  Defaults to 0.
on-end-of-stream:An instance of <object>.  Value returned if reading past the stream.  The default is $not-supplied.
grow?:An instance of <object>.  The default is #f.

Values

sequence-or-eofAn instance of <sequence> or the on-end-of-stream: value.
newline?An instance of <boolean>.
Reads the next element from the stream and advances the stream’s position.
The streams module.
The superclass of all stream classes.
The class of sequences with elements that are characters.
The class of integers.
The class of all Dylan objects.
A constant.
The class of collections whose keys are consecutive integers starting from zero.
The class of boolean values.