diff options
| author | Tobias Klauser <tklauser@distanz.ch> | 2008-01-27 11:37:44 +0100 |
|---|---|---|
| committer | Tobias Klauser <tklauser@xenon.tklauser.home> | 2008-01-27 11:37:44 +0100 |
| commit | 7e0f021a9aec35fd8e6725e87e3313b101d26f5e (patch) | |
| tree | b1cacc4b24393f517aeb4610e9e1021f954307a8 /reference/C/MAN/fopen.htm | |
Initial import (2.0.2-6)2.0.2-6
Diffstat (limited to 'reference/C/MAN/fopen.htm')
| -rw-r--r-- | reference/C/MAN/fopen.htm | 164 |
1 files changed, 164 insertions, 0 deletions
diff --git a/reference/C/MAN/fopen.htm b/reference/C/MAN/fopen.htm new file mode 100644 index 0000000..0e39942 --- /dev/null +++ b/reference/C/MAN/fopen.htm @@ -0,0 +1,164 @@ +<TITLE>fopen</TITLE> +<body bgcolor="#ffffcc"> +<hr> +<pre> + + + +<h3>FOPEN(3) Linux Programmer's Manual FOPEN(3) +</h3> + +<h3>NAME +</h3> fopen, fdopen, freopen - stream open functions + +<h3>SYNOPSIS +</h3> #include <stdio.h> + + FILE *fopen( char *path, char *mode); + FILE *fdopen( int fildes, char *mode); + FILE *freopen( char *path, char *mode, FILE *stream); + +<h3>DESCRIPTION +</h3> The fopen function opens the file whose name is the string + pointed to by path and associates a stream with it. + + The argument mode points to a string beginning with one of + the following sequences (Additional characters may follow + these sequences.): + + r Open text file for reading. The stream is posi- + tioned at the beginning of the file. + + r+ Open for reading and writing. The stream is posi- + tioned at the beginning of the file. + + w Truncate file to zero length or create text file + for writing. The stream is positioned at the + beginning of the file. + + w+ Open for reading and writing. The file is created + if it does not exist, otherwise it is truncated. + The stream is positioned at the beginning of the + file. + + a Open for writing. The file is created if it does + not exist. The stream is positioned at the end of + the file. + + a+ Open for reading and writing. The file is created + if it does not exist. The stream is positioned at + the end of the file. + + The mode string can also include the letter ``b'' either + as a third character or as a character between the charac- + ters in any of the two-character strings described above. + This is strictly for compatibility with ANSI C3.159-1989 + (``ANSI C'') and has no effect; the ``b'' is ignored. + Linux may not behave this way. + + Any created files will have mode + S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH (0666), as + modified by the process' umask value (see umask(2). + + Reads and writes may be intermixed on read/write streams + in any order, and do not require an intermediate seek as + + + +<h3>BSD MANPAGE 29 November 1993 1 +</h3> + + + + +<h3>FOPEN(3) Linux Programmer's Manual FOPEN(3) +</h3> + + in previous versions of stdio. This is not portable to + other systems, however, and may not work under Linux + (someone should find out and fix this manpage); ANSI C + requires that a file positioning function intervene + between output and input, unless an input operation + encounters end-of-file. + + The fdopen function associates a stream with the existing + file descriptor, fildes. The mode of the stream must be + compatible with the mode of the file descriptor. + + The freopen function opens the file whose name is the + string pointed to by path and associates the stream + pointed to by stream with it. The original stream (if it + exists) is closed. The mode argument is used just as in + the fopen function. The primary use of the freopen func- + tion is to change the file associated with a standard text + stream (stderr, stdin, or stdout). + +<h3>RETURN VALUES +</h3> Upon successful completion fopen, fdopen and freopen + return a FILE pointer. Otherwise, NULL is returned and + the global variable errno is set to indicate the error. + +<h3>ERRORS +</h3> EINVAL The mode provided to fopen, fdopen, or freopen was + invalid. + + The fopen, fdopen and freopen functions may also fail and + set errno for any of the errors specified for the routine + malloc(3). + + The fopen function may also fail and set errno for any of + the errors specified for the routine open(2). + + The fdopen function may also fail and set errno for any of + the errors specified for the routine fcntl(2). + + The freopen function may also fail and set errno for any + of the errors specified for the routines open(2), + fclose(3) and fflush(3). + +</pre> +<hr> +<h3>SEE ALSO +</h3><p> +<a href=open.htm>open</a>, +<a href=fclose.htm>fclose</a>, +<pre> + +<h3>STANDARDS +</h3> The fopen and freopen functions conform to ANSI + C3.159-1989 (``ANSI C''). The fdopen function conforms to + IEEE Std1003.1-1988 (``POSIX''). + + + + + + + + +<h3>BSD MANPAGE 29 November 1993 2 +</h3> + +
</pre> +<P> +<hr> +<p> +<center> +<table border=2 width=80%> +<tr align=center> +<td width=25%> +<a href=../cref.html>Top</a> +</td><td width=25%> +<a href=../master_index.html>Master Index</a> +</td><td width=25%> +<a href=../SYNTAX/keywords.html>Keywords</a> +</td><td width=25%> +<a href=../FUNCTIONS/funcref.htm>Functions</a> +</td> +</tr> +</table> +</center> +<p> +<hr> + +This manual page was brought to you by <i>mjl_man V-2.0</i> |