fopen(),fopen64() -- open a file and associate stream

SYNOPSIS

#include <stdio.h>

FILE *fopen(const char *filename, const char *type);

FILE *fopen64(const char *filename, const char *type);

DESCRIPTION

The fopen() function opens the file named by filename and associates a stream with it. This function returns a pointer to the FILE structure associated with the stream.

Opening the file for reading fails if the file does not exist or cannot be read.

Opening the file for append causes all subsequent writes to the file to be forced to the then current end of file, regardless of intervening calls to the fseek() function.

When a file is opened for update, both input and output may be performed on the associated stream. However, output may not be directly followed by input without an intervening call to the fflush() function or to a file positioning function (fseek(), fsetpos(), or rewind()), and input may not be directly followed by output without an intervening call to a file positioning function unless the input operation encounters end-of-file.

When a stream is opened, it is fully buffered only if it does not refer to an interactive device. The error and end-of-file indicators are cleared for the stream.

The fopen64() function is identical to the fopen() function except that the underlying file descriptor is created with the O_LARGEFILE flag set. The fopen64() function is a part of the large-file extensions.

PARAMETERS

filename

Points to a character string that contains the name of the file to be opened.

type

Indicates a character string that specifies the desired type of file access. The first character of this string must be one of r (open for reading), w (open for writing), or a (open for writing at the end of file —append).

After the first character, you can specify several optional modifiers: b, open in binary mode; t, open in text mode, +, open for update (both reading and writing); S, optimize performance for sequential access; R, optimize performance for random access; D, file should be deleted when the last file descriptor is closed; T, optimize performance for short-lived temporary files.

RETURN VALUES

On failure, the fopen() and fopen64() functions return a NULL pointer and errno is set to one of the following values:

EACCES: Search permission is denied on a component of the path prefix, or the file exists and the permissions specified by mode are denied, or the file does not exist and write permission is denied for the parent directory of the file to be created.
EINVAL: The value of the type argument is invalid.
EISDIR: The named file is a directory, and type requires write access.
EMFILE: Too many file descriptors are open in the calling process.
ENOENT: A component of filename does not name an existing file, or filename is an empty string.
ENOMEM: Insufficient storage space is available.
ENOTDIR: A component of the path prefix is not a directory.
EOVERFLOW: The named file is a regular file and the size of the file cannot be represented correctly in an object of type off_t.
ETXTBSY: The file is an executable that is in use, and type requires write access.

CONFORMANCE

ANSI/ISO 9899-1990, with exceptions.

fopen64(): Large File Specification, revision 1.5.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

The modifiers D, T, R, S, and t are PTC MKS Toolkit UNIX APIs extensions, and are not guaranteed to be portable. If neither b nor t is specified, the determination of binary or text is made by examining the current state of the BINARY_OFLAG (see _NutConf() for details).

AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition

fopen(), fopen64()
open a file and associate stream

Function