Return to fopen.3 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man3

Annotation of researchv10dc/man/adm/man3/fopen.3, revision 1.1.1.1

1.1       root        1: .TH FOPEN 3S
                      2: .CT 2 file_io
                      3: .SH NAME
                      4: fopen, freopen, fdopen, fclose, fflush \(mi open, close, or flush a stream
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B #include <stdio.h>
                      8: .PP
                      9: .B FILE *fopen(filename, type)
                     10: .B char *filename, *type;
                     11: .PP
                     12: .B FILE *freopen(filename, type, stream)
                     13: .B char *filename, *type;
                     14: .B FILE *stream;
                     15: .PP
                     16: .B FILE *fdopen(fildes, type)
                     17: .B char *type;
                     18: .PP
                     19: .B int fclose(stream)
                     20: .B FILE *stream;
                     21: .PP
                     22: .B int fflush(stream)
                     23: .B FILE *stream;
                     24: .fi
                     25: .SH DESCRIPTION
                     26: .I Fopen
                     27: opens the file named by
                     28: .I filename
                     29: and associates a stream with it.
                     30: .I Fopen
                     31: returns a pointer to be used to identify
                     32: the stream in subsequent operations.
                     33: .PP
                     34: .I Type
                     35: is a character string having one of the following values:
                     36: .nf
                     37: .ta 8n
                     38: \fL"r"\fP      open for reading
                     39: \fL"w"\fP      create for writing
                     40: \fL"r+w"\fP
                     41: \fL"w+r"\fP    open for reading and writing
                     42: \fL"a"\fP      append: open for writing at end of file, or create for writing
                     43: .fi
                     44: .PP
                     45: .I Freopen
                     46: substitutes the named file in place
                     47: of the open
                     48: .IR stream .
                     49: It returns the original value of
                     50: .IR stream .
                     51: The original stream is closed.
                     52: .I Freopen
                     53: is typically used to attach the preopened
                     54: constant names
                     55: .LR stdin ,
                     56: .L stdout
                     57: and
                     58: .L stderr
                     59: to specified files.
                     60: .PP
                     61: .I Fdopen
                     62: associates a stream with a file descriptor.
                     63: The
                     64: .I type
                     65: of the stream must agree with the mode of the open file.
                     66: .PP
                     67: .I Fclose
                     68: causes any buffers for the named
                     69: .I stream
                     70: to be emptied, and the file to be closed.
                     71: Buffers allocated by the standard input/output system
                     72: are freed.
                     73: .PP
                     74: .I Fclose
                     75: is performed automatically upon
                     76: calling
                     77: .IR  exit (3).
                     78: .PP
                     79: .I Fflush
                     80: causes any buffered data for the named output
                     81: .I stream
                     82: to be written to that file.
                     83: The stream remains open.
                     84: .SH "SEE ALSO"
                     85: .IR open (2),
                     86: .IR popen (3),
                     87: .IR stdio (3),
                     88: .IR ferror (3)
                     89: .SH DIAGNOSTICS
                     90: .I Fopen
                     91: and
                     92: .I freopen
                     93: return
                     94: .B NULL
                     95: if
                     96: .I filename
                     97: cannot be accessed.
                     98: .PP
                     99: .I Fclose
                    100: and
                    101: .I fflush
                    102: return
                    103: .B EOF
                    104: if
                    105: .I stream
                    106: is not associated with a file, or
                    107: if buffered data cannot be transferred to that file.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.