port -- r7rs Type

§

Sub-types tree

§

• port-open:
  • input-port-open:
    • input-port-eof:
      • ...
    • binary-input-port-open:
      • ...
    • textual-input-port-open:
      • ...
  • output-port-open:
    • binary-output-port-open;
    • textual-output-port-open;
  • binary-port-open:
    • binary-input-port-open:
      • ...
    • binary-output-port-open;
  • textual-port-open:
    • textual-input-port-open:
      • ...
    • textual-output-port-open;
• port-closed:
  • input-port-closed:
    • binary-input-port-closed;
    • textual-input-port-closed;
  • output-port-closed:
    • binary-output-port-closed;
    • textual-output-port-closed;
  • binary-port-closed:
    • binary-input-port-closed;
    • binary-output-port-closed;
  • textual-port-closed:
    • textual-input-port-closed;
    • textual-output-port-closed;
• input-port:
  • input-port-open:
    • input-port-eof:
      • ...
    • binary-input-port-open:
      • ...
    • textual-input-port-open:
      • ...
  • input-port-closed:
    • binary-input-port-closed;
    • textual-input-port-closed;
  • binary-input-port:
    • binary-input-port-open:
      • ...
    • binary-input-port-closed;
  • textual-input-port:
    • textual-input-port-open:
      • ...
    • textual-input-port-closed;
  • bytevector-input-port;
  • string-input-port;
• output-port:
  • output-port-open:
    • binary-output-port-open;
    • textual-output-port-open;
  • output-port-closed:
    • binary-output-port-closed;
    • textual-output-port-closed;
  • binary-output-port:
    • binary-output-port-open;
    • binary-output-port-closed;
  • textual-output-port:
    • textual-output-port-open;
    • textual-output-port-closed;
  • bytevector-output-port;
  • string-output-port;
• binary-port:
  • binary-port-open:
    • binary-input-port-open:
      • ...
    • binary-output-port-open;
  • binary-port-closed:
    • binary-input-port-closed;
    • binary-output-port-closed;
  • binary-input-port:
    • binary-input-port-open:
      • ...
    • binary-input-port-closed;
  • binary-output-port:
    • binary-output-port-open;
    • binary-output-port-closed;
• textual-port:
  • textual-port-open:
    • textual-input-port-open:
      • ...
    • textual-output-port-open;
  • textual-port-closed:
    • textual-input-port-closed;
    • textual-output-port-closed;
  • textual-input-port:
    • textual-input-port-open:
      • ...
    • textual-input-port-closed;
  • textual-output-port:
    • textual-output-port-open;
    • textual-output-port-closed;
• bytevector-port:
  • bytevector-input-port;
  • bytevector-output-port;
• string-port:
  • string-input-port;
  • string-output-port;

Super-types

§

• (none);

Sub-types

§

• port-open;
• port-closed;
• input-port;
• output-port;
• binary-port;
• textual-port;
• bytevector-port;
• string-port;

Sub-types recursive

§

• input-port-open;
• input-port-eof;
• input-port-closed;
• output-port-open;
• output-port-closed;
• binary-port-open;
• binary-port-closed;
• binary-input-port;
• binary-input-port-open;
• binary-input-port-eof;
• binary-input-port-closed;
• binary-output-port;
• binary-output-port-open;
• binary-output-port-closed;
• textual-port-open;
• textual-port-closed;
• textual-input-port;
• textual-input-port-open;
• textual-input-port-eof;
• textual-input-port-closed;
• textual-output-port;
• textual-output-port-open;
• textual-output-port-closed;
• bytevector-input-port;
• bytevector-output-port;
• string-input-port;
• string-output-port;

Referent definitions as input

§

• port?;
• binary-port?;
• textual-port?;
• input-port?;
• input-port-open?;
• output-port?;
• output-port-open?;
• call-with-port;

Predicate

§

port?

Description

§

Ports represent input and output devices. To Scheme, an input port is a Scheme object that can deliver data upon command, while an output port is a Scheme object that can accept data. Whether the input and output port types are disjoint is implementation-dependent.

Different port types operate on different data. Scheme implementations are required to support textual ports and binary ports, but may also provide other port types.

A textual port supports reading or writing of individual characters from or to a backing store containing characters using read-char and write-char below, and it supports operations defined in terms of characters, such as read and write.

A binary port supports reading or writing of individual bytes from or to a backing store containing bytes using read-u8 and write-u8 below, as well as operations defined in terms of bytes. Whether the textual and binary port types are disjoint is implementation-dependent.

Ports can be used to access files, devices, and similar things on the host system on which the Scheme program is running.

---

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

Categories

§

• types-disjoint;
• types-ports;

Categories recursive

§

• types;