Next Prev Up Top Contents Index

13.1 Basic Output Streams

CLIM performs all of its input and output operations on objects called streams . Stream functionality is partitioned into two layers: the basic stream protocol and the extended stream protocol. The stream-oriented output layer is implemented on top of the sheet output architecture. The basic CLIM output stream protocol is based on the character output 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 output stream facilities. This protocol is documented in Appendix E, Common Lisp Streams

standard-output-stream

Summary: This class provides an implementation of the CLIM basic output stream protocol, based on the CLIM output kernel. Members of this class are mutable.

stream-write-char [Generic Function]

Arguments: stream character

Summary: Writes the character character t o the output stream stream , and returns character as its value.

stream-line-column [Generic Function]

Arguments: stream

Summary: This function returns the column number where the next character will be written on the output stream stream . The first column on a line is numbered 0.

stream-start-line-p [Generic Function]

Arguments: stream

Summary: Returns t if the output stream stream is positioned at the beginning of a line (that is, column 0); otherwise, it returns nil .

stream-write-string [Generic Function]

Arguments: stream string &optiona l (start 0 ) end

Summary: Writes the string string to the output stream stream . If start and end are supplied, they are integers that specify what part of string to output. string is returned as the value.

stream-terpri [Generic Function]

Arguments: stream

Summary: Writes an end-of-line character on the output stream stream , and returns nil .

stream-fresh-line [Generic Function]

Arguments: stream

Summary: Writes an end-of-line character on the output stream stream only if the stream is not at the beginning of the line.

stream-finish-output [Generic Function]

Arguments: stream

Summary: Ensures that all the output sent to the output stream stream has reached its destination, and only then does it return nil .

stream-force-output [Generic Function]

Arguments: stream

Summary: Like stream-finish-output , except that it may immediately return nil without waiting for the output to complete.

stream-clear-output [Generic Function]

Arguments: stream

Summary: Aborts any outstanding output operation in progress on the output stream stream , and returns nil .

stream-advance-to-column [Generic Function]

Arguments: stream column

Summary: Writes enough blank space on the output stream stream so that the next character will be written at the position specified by column , which is an integer.


CommonLisp Interface Manager 2.0 User's Guide - 8 Aug 2003

Next Prev Up Top Contents Index