Netscape ENTERPRISE SERVER 6.1, Руководство пользователя

Страница: 149 / 373

NSAPI Functions (in Alphabetical Order)
Chapter 5 NSAPI Function Reference 149
filebuf_open
The
filebuf_open
function opens a new file buffer for a previously opened file. It
returns a new buffer structure. Buffered files provide more efficient file access by
guaranteeing the use of buffered file I/O in environments where it is not supported
by the operating system.
Syntax
filebuf *filebuf_open(SYS_FILE fd, int sz);
Returns
A pointer to a new buffer structure to hold the data, if successful or
NULL
if no
buffer could be opened.
Parameters
SYS_FILE fd
is the platform-independent file descriptor of the file which has
already been opened.
int sz
is the size, in bytes, to be used for the buffer.
Example
filebuf *buf = filebuf_open(fd, FILE_BUFFERSIZE);
if (!buf) {
system_fclose(fd);
}
See also
filebuf_getc, filebuf_buf2sd, filebuf_close, filebuf_open_nostat
filebuf_open_nostat
The
filebuf_open_nostat
function opens a new file buffer for a previously
opened file. It returns a new buffer structure. Buffered files provide more efficient
file access by guaranteeing the use of buffered file I/O in environments where it is
not supported by the operating system.
This function is the same
filebuf_open
, but is more efficient, since it does not
need to call the
request_stat_path
function. It requires that the stat information
be passed in.
Syntax
filebuf* filebuf_open_nostat(SYS_FILE fd, int sz,
struct stat *finfo);