Read-bytes$-n
Flexible macro for reading whole lists of n 1-, 2-, 4-, or
8-byte values from an open :byte input stream.
General form:
(read-bytes$-n n channel
[:bytes bytes] ;; default: 1
[:signed signed] ;; default: nil
[:end end] ;; default: :big
)
The bytes, signed, and end arguments are as in read-bytes$.
The number n says how many values to read. The actual number of bytes
that will be read is therefore n * bytes. E.g., reading three 8-byte
values will consume a total of 24 bytes from the input stream.
If EOF is reached before n * bytes bytes are read from the stream, then
we return fail. Otherwise, we return an n-element list, where every
member is an appropriate integer for this combination of signedness and
size.
Subtopics
- Read-64ule-n
- (read-64ule-n n channel state) reads n 64-bit, unsigned,
little-endian values from the input channel and
returns them as a list.
- Read-64ube-n
- (read-64ube-n n channel state) reads n 64-bit, unsigned,
big-endian values from the input channel and returns
them as a list.
- Read-64sle-n
- (read-64sle-n n channel state) reads n 64-bit, signed,
little-endian values from the input channel and
returns them as a list.
- Read-64sbe-n
- (read-64sbe-n n channel state) reads n 64-bit, signed,
big-endian values from the input channel and returns
them as a list.
- Read-32ule-n
- (read-32ule-n n channel state) reads n 32-bit, unsigned,
little-endian values from the input channel and
returns them as a list.
- Read-32ube-n
- (read-32ube-n n channel state) reads n 32-bit, unsigned,
big-endian values from the input channel and returns
them as a list.
- Read-32sle-n
- (read-32sle-n n channel state) reads n 32-bit, signed,
little-endian values from the input channel and
returns them as a list.
- Read-32sbe-n
- (read-32sbe-n n channel state) reads n 32-bit, signed,
big-endian values from the input channel and returns
them as a list.
- Read-16ule-n
- (read-16ule-n n channel state) reads n 16-bit, unsigned,
little-endian values from the input channel and
returns them as a list.
- Read-16ube-n
- (read-16ube-n n channel state) reads n 16-bit, unsigned,
big-endian values from the input channel and returns
them as a list.
- Read-16sle-n
- (read-16sle-n n channel state) reads n 16-bit, signed,
little-endian values from the input channel and
returns them as a list.
- Read-16sbe-n
- (read-16sbe-n n channel state) reads n 16-bit, signed,
big-endian values from the input channel and returns
them as a list.
- Read-byte$-n
- (read-byte$-n n channel state) reads n unsigned bytes from
the input channel and returns them as a list.
- Read-8s-n
- (read-8s-n n channel state) reads n signed bytes from the
input channel and returns them as a list.
