(use-modules (ice-9 rw))

— Scheme Procedure: read-string!/partial str [port/fdes [start [end]]]
— C Function: scm_read_string_x_partial (str, port/fdes, start, end)

Read characters from port/fdes into a string str. A port must have an underlying file descriptor — a so-called fport. This procedure is scsh-compatible and can efficiently read large strings. It will:

• attempt to fill the entire string, unless the start and/or end arguments are supplied (i.e., start defaults to 0 and end defaults to (string-length str));
• use the current input port if port/fdes is not supplied;
• return fewer than the requested number of characters in some cases, e.g., on end of file, if interrupted by a signal, or if not all the characters are immediately available;
• wait indefinitely for some input if no characters are currently available, unless the port is in non-blocking mode;
• read characters from the port's input buffers if available, instead from the underlying file descriptor;
• return #f if end-of-file is encountered before reading any characters, otherwise return the number of characters read;
• return 0 if the port is in non-blocking mode and no characters are immediately available;
• return 0 if the request is for 0 bytes, with no end-of-file check.

— Scheme Procedure: read-string!/partial/never-fewer buf port rd-offset len wr-offset

Read len bytes into string buf starting at wr-offset, from port starting at rd-offset. If rd-offset is #f, use the current position. If rd-offset is an integer, port must be seekable. This proc is basically a loop around read-string!/partial.

— Scheme Procedure: write-string/partial str [port/fdes [start [end]]]
— C Function: scm_write_string_partial (str, port/fdes, start, end)

Write characters from a string str to port/fdes. A port must have an underlying file descriptor — a so-called fport. This procedure is scsh-compatible and can efficiently write large strings. It will:

• attempt to write the entire string, unless the start and/or end arguments are supplied (i.e., start defaults to 0 and end defaults to (string-length str));
• use the current output port if port/fdes is not supplied;
• in the case of a buffered port, store the characters in the port's output buffer, if all will fit. If they will not fit then any existing buffered characters will be flushed before attempting to write the new characters directly to the underlying file descriptor. If the port is in non-blocking mode and buffered characters can not be flushed immediately, then an EAGAIN system-error exception will be raised. (Note: scsh does not support the use of non-blocking buffered ports.)
• write fewer than the requested number of characters in some cases, e.g., if interrupted by a signal or if not all of the output can be accepted immediately;
• wait indefinitely for at least one character from str to be accepted by the port, unless the port is in non-blocking mode;
• return the number of characters accepted by the port;
• return 0 if the port is in non-blocking mode and can not accept at least one character from str immediately;
• return 0 immediately if the request size is 0 bytes.

— Scheme Procedure: write-string/partial/never-fewer str [port/fdes [start [end]]]

Like write-string/partial, except that if fewer bytes than specified (that is, end − start) are written, loop until all of them are indeed output.