stream-read-partial-unsafe ( n buf stream -- count ) (original) (raw)

Vocabulary
io

Inputs

n a non-negative integer
buf a c-ptr or a string
stream an input stream

Outputs

Generic word contract
Reads up to n elements from the stream without blocking. If no data is available immediately on the stream, blocks until data is available. The data is stored directly into the buffer provided by buf, which must be a string (in the case of a character stream), or a byte array, specialized array, or other pointer to memory (in the case of a byte stream). There must be space in the buffer for at least n elements. Returns the number of elements read from the stream, or zero if the end of the stream was reached.

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

Definition

Methods