read-bytevector! -- r7rs Definition

§

Kind

§

procedure!;

Implemented by

§

• read-bytevector! (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((bytevector-not-empty) -> (range-length-not-zero-or-eof))
  • input: a value of type bytevector-not-empty;
  • output: a value of type range-length-not-zero-or-eof;
• ((bytevector-not-empty binary-input-port-eof) -> (eof-object))
  • inputs:
    • a value of type bytevector-not-empty;
    • a value of type binary-input-port-eof;
  • output: a value of type eof-object;
• ((bytevector-not-empty binary-input-port-open) -> (range-length-not-zero-or-eof))
  • inputs:
    • a value of type bytevector-not-empty;
    • a value of type binary-input-port-open;
  • output: a value of type range-length-not-zero-or-eof;
• ((bytevector-not-empty binary-input-port-eof range-start) -> (eof-object))
  • inputs:
    • a value of type bytevector-not-empty;
    • a value of type binary-input-port-eof;
    • a value of type range-start;
  • output: a value of type eof-object;
• ((bytevector-not-empty binary-input-port-open range-start) -> (range-length-not-zero-or-eof))
  • inputs:
    • a value of type bytevector-not-empty;
    • a value of type binary-input-port-open;
    • a value of type range-start;
  • output: a value of type range-length-not-zero-or-eof;
• ((bytevector-not-empty binary-input-port-eof range-start range-end) -> (eof-object))
  • inputs:
    • a value of type bytevector-not-empty;
    • a value of type binary-input-port-eof;
    • a value of type range-start;
    • a value of type range-end;
  • output: a value of type eof-object;
• ((bytevector-not-empty binary-input-port-open range-start range-end) -> (range-length-not-zero-or-eof))
  • inputs:
    • a value of type bytevector-not-empty;
    • a value of type binary-input-port-open;
    • a value of type range-start;
    • a value of type range-end;
  • output: a value of type range-length-not-zero-or-eof;

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(read-bytevector! bytevector)
(read-bytevector! bytevector port)
(read-bytevector! bytevector port start)
(read-bytevector! bytevector port start end)

Reads the next end - start bytes, or as many as are available before the end of file, from the binary input port into bytevector in left-to-right order beginning at the start position. If end is not supplied, reads until the end of bytevector has been reached. If start is not supplied, reads beginning at position 0. Returns the number of bytes read. If no bytes are available, an end-of-file object is returned.

---

The text herein was sourced and adapted as described in the "R7RS attribution of various text snippets" appendix.

Referenced-types

§

• bytevector-not-empty;
• range-length-not-zero-or-eof;
• binary-input-port-eof;
• eof-object;
• binary-input-port-open;
• range-start;
• range-end;