Netscape ENTERPRISE SERVER 6.1, Manual

Page: 157 / 373

NSAPI Functions (in Alphabetical Order)
Chapter 5 NSAPI Function Reference 157
Returns
The integer representing the character, if one was retrieved or the constant
IO_EOF
or
IO_ERROR
, for end of file or error
Parameters
netbuf b
is the buffer from which to retrieve one character.
See also
netbuf_buf2sd, netbuf_close
,
netbuf_grab
,
netbuf_open
netbuf_grab
The
netbuf_grab
function reads
sz
number of bytes from the network buffer’s
(
buf
) socket into the network buffer. If the buffer is not large enough it is resized.
The data can be retrieved from
buf->inbuf
on success.
This function is used by the function
netbuf_buf2sd
.
Syntax
int netbuf_grab(netbuf *buf, int sz);
Returns
The number of bytes actually read (between 1 and
sz
), if the operation was
successful or the constant
IO_EOF
or
IO_ERROR
, for end of file or error
Parameters
netbuf *buf
is the buffer to read into.
int sz
is the number of bytes to read.
See also
netbuf_buf2sd, netbuf_close, netbuf_getc, netbuf_open
netbuf_open
The
netbuf_open
function opens a new network buffer and returns it. You can use
netbuf_open
to create a
netbuf
structure and start using buffered I/O on a socket.
Syntax
netbuf* netbuf_open(SYS_NETFD sd, int sz);
Returns
A pointer to a new
netbuf
structure (network buffer)