7.2 Input/Output system extensions

7.2.3 Buffered interface

The buffered interface allows you to check out a buffer that a stream is using; that is, you can directly read or modify the I/O buffer. The interface contains the following functions:

buffer-ref get-input-buffer get-input-buffer-no-hang get-output-buffer return-input-buffer return-output-buffer

The buffer is owned at all times by the stream. You cannot perform an I/O operation on the stream while you have the buffer checked out. You should not close the stream when the buffer is checked out unless you do not want to save the changes you have made to the buffer; in that case, you should invoke the Common Lisp functionclose on the stream and specify a non-nil value for the:abort keyword argument.

The Advanced User's Guide - 9 SEP 1996

Generated with Harlequin WebMaker