FreeBSD Manual Pages
_xt_ff_raw_open(3) Library Functions Manual _xt_ff_raw_open(3) NAME _xt_ff_raw_open() - Open a fast file stream for a raw file LIBRARY #include <fcntl.h> #include <xtend/fast-file.h> -lxtend SYNOPSIS xt_ff_t *_xt_ff_raw_open(const char *filename, int flags) ARGUMENTS filename Absolute or relative path of the file to open flags Bit flags passed to open(3) DESCRIPTION _xt_ff_raw_open(3) initializes a xt_ff_t stream, much as fopen(3) does for a FILE stream. Unlike fopen(3), _xt_ff_raw_open(3) takes the same bit mask argument as open(2) to determine the open mode. See open(3) for details. An optimally sized buffer for the underlying filesystem is allocated, along with additional space for limited xt_ff_ungetc(3) operations. The xt_ff_t system is simpler than and much faster than traditional FILE on typical systems. It is intended for processing large files character-by-character, where low-level block I/O is not convenient, but FILE I/O causes a bottleneck. RETURN VALUES A pointer to a xt_ff_t object on success, NULL on failure EXAMPLES xt_ff_t *stream; char *filename; // Read only stream = _xt_ff_raw_open(filename, O_RDONLY); // Overwrite stream = _xt_ff_raw_open(filename, O_WRONLY|O_CREAT|O_TRUNC); // Append stream = _xt_ff_raw_open(filename, O_WRONLY|O_APPEND); SEE ALSO open(3), xt_ff_getc(3), xt_ff_putc(3), xt_ff_ungetc(3), xt_ff_close(3) _xt_ff_raw_open(3)
NAME | LIBRARY | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURN VALUES | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=_xt_ff_raw_open&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>