write-octets

Function

Package: excl

Arguments: stream buffer start end blocking

Writes as many octets from the stream as possible. The output handle is examined, and if it is a stream (i.e. encapsulated), the stream is read from in a manner similar to write-vector, except that no further checking of arguments is done; it is assumed that the caller has done whatever checking that is necessary. Otherwise, if the handle is an operating-system-defined handle, the system write function is called.

Return values:

• A number greater than or equal to 0: the number of bytes actually read. 0 bytes are only ever transferred when blocking is nil.
• -3: Special return value for a no-hang query. If the start and end arguments are eql and if blocking is nil, then a 0 return means no data can be written, and a -3 value means data could have been written.
• (- -10 errno): the value of the error return from the system operation. For example, -19 represents an errno valur of 9, which is EBADF (bad file number) on most systems.

See streams.htm for information on the simple-streams implementation in Allegro CL.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.