read-until ( seps -- seq sep/f )
Factor handbook » Input and output » Streams » Default input and output streams

Prev:	read-into ( buf -- buf-slice more? )
Next:	read-partial ( n -- seq )

Vocabulary
io

Inputs

seps

a string

Outputs

seq	a byte-array, a string, or f
sep/f	a character or f

Generic word contract
Reads elements from input-stream until the first occurrence of a separator, or stream exhaustion. In the former case, the separator character is pushed on the stack, and is not part of the output. In the latter case, the entire stream contents are output, along with f.

Errors
Throws an error if the I/O operation fails.

Definition

USING: namespaces ;

IN: io

: read-until ( seps -- seq sep/f )
    input-stream get stream-read-until ; inline