read-into ( buf -- buf-slice more? )

read-into ( buf -- buf-slice more? )
Factor handbook » Input and output » Streams » Default input and output streams

Prev:	read ( n -- seq )
Next:	read-until ( seps -- seq sep/f )

Vocabulary
io

Inputs

buf	a byte-array, a specialized-array, or a string

Outputs

buf-slice	a slice
more?	a boolean

Generic word contract
Reads from the current input-stream into the sequence buf, until either the length of buf is reached or the stream is exhausted. Returns a slice over the part of buf that was written to, and a boolean value that will be f if the stream was exhausted.

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

Definition

USING: namespaces ;

IN: io

: read-into ( buf -- buf-slice more? )
input-stream get stream-read-into ; inline