_flushlbf(3S)

NAME | SYNOPSIS | DESCRIPTION | USAGE | ATTRIBUTES | SEE ALSO

NAME

__fbufsize, __flbf, __fpending, __fpurge, __freadable, __freading, __fwritable, __fwriting, _flushlbf- interfaces to stdio FILE structure

SYNOPSIS

#include <stdio.h>
#include <stdio_ext.h>

size_t __fbufsiz(FILE *stream);
int __flbf(FILE *stream);
size_t __fpending(FILE *stream);
void __fpurge(FILE *stream);
int __freadable(FILE *stream);
int __freading(FILE *stream);
int __fwritable(FILE *stream);
int __fwriting(FILE *stream);
void _flushlbf(void);

DESCRIPTION

These functions provide portable access to the members of the stdio(3S) FILE structure.

The __fbufsize() function returns in bytes the size of the buffer currently in use by the given stream.

The __flbf() function returns non-zero if the stream is line-buffered.

The __fpending function returns in bytes the amount of output pending on a stream.

The __fpurge() function discards any pending buffered I/O on the stream.

The __freadable() function returns non-zero if it is possible to read from a stream.

The __freading() function returns non-zero if the file is open readonly, or if the last operation on the stream was a read operation such as fread(3S) or fgetc(3S). Otherwise it returns 0.

The __fwritable() function returns non-zero if it is possible to write on a stream.

The __fwriting() function returns non-zero if the file is open write-only or append-only, or if the last operation on the stream was a write operation such as fwrite(3S) or fputc(3S). Otherwise it returns 0.

The _flushlbf() function flushes all line-buffered files. It is used when reading from a line-buffered file.

USAGE

Although the contents of the stdio FILE structure have always been private to the stdio implementation, some applications have needed to obtain information about a stdio stream that was not accessible through a supported interface. These applications have resorted to accessing fields of the FILE structure directly, rendering them possibly non-portable to new implementations of stdio, or more likely, preventing enhancements to stdio that would cause those applications to break.

In the 64-bit environment, the FILE structure is opaque. The functions described here are provided as a means of obtaining the information that up to now has been retrieved directly from the FILE structure. Because they are based on the needs of existing applications (such as mh and emacs), they may be extended as other programs are ported. Although they may still be non-portable to other operating systems, they will be compatible from each Solaris release to the next. Interfaces that are more portable are under development.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	MT-Safe
Interface Stability	Evolving

SEE ALSO

fgetc(3S), fputc(3S), fread(3S), fwrite(3S), stdio(3S), attributes(5)

SunOS 5.7  Last Revised 5 Feb 1998

NAME | SYNOPSIS | DESCRIPTION | USAGE | ATTRIBUTES | SEE ALSO