All Manuals > CLIM 2.0 User Guide > 15 Extended Stream Input Facilities

15.1 Basic Input Streams

CLIM provides a stream-oriented input layer that is implemented on top of the sheet input architecture. The basic CLIM input stream protocol is based on the character input stream protocol proposal submitted to the ANSI Common Lisp committee by David Gray. This proposal was not approved by the committee, but CLIM provides an implementation of the basic input stream facilities.

standard-input-stream Class

Summary: This class provides an implementation of the CLIM's basic input stream protocol based on CLIM's input kernel. It defines a handle-event method for keystroke events and queues the resulting characters in a per-stream input buffer. Members of this class are mutable.

stream-read-char Generic Function

stream-read-char stream

Summary: Returns the next character available in the input stream stream, or :eof if the stream is at end-of-file. If no character is available, this function will wait until one becomes available.

stream-unread-char Generic Function

stream-unread-char stream character

Summary: Places the character character back into the input stream stream's input buffer. The next call to read-char on stream will return the unread character. The character supplied must be the most recent character read from the stream.

stream-read-char-no-hang Generic Function

stream-read-char-no-hang stream

Summary: Like stream-read-char, except that if no character is available, the function returns nil.

stream-peek-char Generic Function

stream-peek-char stream

Summary: Returns the next character available in the input stream stream. The character is not removed from the input buffer, so the same character will be returned by a subsequent call to stream-read-char.

stream-listen Generic Function

stream-listen stream

Summary: Returns t if there is input available on the input stream stream, nil if not.

stream-read-line Generic Function

stream-read-line stream

Summary: Reads and returns a string containing a line of text from the input stream stream, delimited by the #\Newline character.

stream-clear-input Generic Function

stream-clear-input stream

Summary: Clears any buffered input associated with the input stream stream and returns nil.


CLIM 2.0 User Guide - 01 Dec 2021 19:39:00