From 754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sun, 7 Apr 2024 13:41:34 -0500 Subject: new repository --- devdocs/c/io.html | 155 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 devdocs/c/io.html (limited to 'devdocs/c/io.html') diff --git a/devdocs/c/io.html b/devdocs/c/io.html new file mode 100644 index 00000000..fb93bb9d --- /dev/null +++ b/devdocs/c/io.html @@ -0,0 +1,155 @@ +

File input/output

The <stdio.h> header provides generic file operation support and supplies functions with narrow character input/output capabilities.

+

The <wchar.h> header supplies functions with wide character input/output capabilities.

+

I/O streams are denoted by objects of type FILE that can only be accessed and manipulated through pointers of type FILE*. Each stream is associated with an external physical device (file, standard input stream, printer, serial port, etc).

+

Types

+ + +
Defined in header <stdio.h>
object type, capable of holding all information needed to control a C I/O stream
(typedef)
non-array complete object type, capable of uniquely specifying a position and multibyte parser state in a file
(typedef)

Predefined standard streams

+ +
Defined in header <stdio.h>
expression of type FILE* associated with the input stream
expression of type FILE* associated with the output stream
expression of type FILE* associated with the error output stream
(macro constant)

Functions

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
File access
Defined in header <stdio.h>
+
(C11)
 opens a file
(function)
+
(C11)
 open an existing stream with a different name
(function)
closes a file
(function)
synchronizes an output stream with the actual file
(function)
sets the buffer for a file stream
(function)
sets the buffer and its size for a file stream
(function)
Defined in header <wchar.h>
+
(C95)
 switches a file stream between wide character I/O and narrow character I/O
(function)
Direct input/output
Defined in header <stdio.h>
reads from a file
(function)
writes to a file
(function)
Unformatted input/output
+
Narrow character
Defined in header <stdio.h>
gets a character from a file stream
(function)
gets a character string from a file stream
(function)
writes a character to a file stream
(function)
writes a character string to a file stream
(function)
reads a character from stdin
(function)
+
(removed in C11)(C11)
 reads a character string from stdin
(function)
writes a character to stdout
(function)
writes a character string to stdout
(function)
puts a character back into a file stream
(function)
+
Wide character
Defined in header <wchar.h>
+
(C95)
 gets a wide character from a file stream
(function)
+
(C95)
 gets a wide string from a file stream
(function)
+
(C95)
 writes a wide character to a file stream
(function)
+
(C95)
 writes a wide string to a file stream
(function)
+
(C95)
 reads a wide character from stdin
(function)
+
(C95)
 writes a wide character to stdout
(function)
+
(C95)
 puts a wide character back into a file stream
(function)
Formatted input/output
+
Narrow character
Defined in header <stdio.h>
+
(C11)(C11)(C11)
 reads formatted input from stdin, a file stream or a buffer
(function)
+
(C99)(C99)(C99)(C11)(C11)(C11)
 reads formatted input from stdin, a file stream or a buffer
using variable argument list
(function)
+
(C99)(C11)(C11)(C11)(C11)
 prints formatted output to stdout, a file stream or a buffer
(function)
+
(C99)(C11)(C11)(C11)(C11)
 prints formatted output to stdout, a file stream or a buffer
using variable argument list
(function)
+
Wide character
Defined in header <wchar.h>
+
(C95)(C95)(C95)(C11)(C11)(C11)
 reads formatted wide character input from stdin, a file stream or a buffer
(function)
+
(C99)(C99)(C99)(C11)(C11)(C11)
 reads formatted wide character input from stdin, a file stream
or a buffer using variable argument list
(function)
+
(C95)(C95)(C95)(C11)(C11)(C11)(C11)
 prints formatted wide character output to stdout, a file stream or a buffer
(function)
+
(C95)(C95)(C95)(C11)(C11)(C11)(C11)
 prints formatted wide character output to stdout, a file stream
or a buffer using variable argument list
(function)
File positioning
Defined in header <stdio.h>
returns the current file position indicator
(function)
gets the file position indicator
(function)
moves the file position indicator to a specific location in a file
(function)
moves the file position indicator to a specific location in a file
(function)
moves the file position indicator to the beginning in a file
(function)
Error handling
Defined in header <stdio.h>
clears errors
(function)
checks for the end-of-file
(function)
checks for a file error
(function)
displays a character string corresponding of the current error to stderr
(function)
Operations on files
Defined in header <stdio.h>
erases a file
(function)
renames a file
(function)
+
(C11)
 returns a pointer to a temporary file
(function)
+
(C11)
 returns a unique filename
(function)

Macro constants

+ + + + + + + + +
Defined in header <stdio.h>
EOF
 integer constant expression of type int and negative value
(macro constant)
FOPEN_MAX
 maximum number of files that can be open simultaneously
(macro constant)
FILENAME_MAX
 size needed for an array of char to hold the longest supported file name
(macro constant)
BUFSIZ
 size of the buffer used by setbuf
(macro constant)
_IOFBF_IOLBF_IONBF
 argument to setvbuf indicating fully buffered I/O
argument to setvbuf indicating line buffered I/O
argument to setvbuf indicating unbuffered I/O
(macro constant)
SEEK_SETSEEK_CURSEEK_END
 argument to fseek indicating seeking from beginning of the file
argument to fseek indicating seeking from the current file position
argument to fseek indicating seeking from end of the file
(macro constant)
TMP_MAXTMP_MAX_S
+
(C11)
 maximum number of unique filenames that can be generated by tmpnam
maximum number of unique filenames that can be generated by tmpnam_s
(macro constant)
L_tmpnamL_tmpnam_s
+
(C11)
 size needed for an array of char to hold the result of tmpnam
size needed for an array of char to hold the result of tmpnam_s
(macro constant)

References

See also

+
C++ documentation for C-style file input/output
+

+ © cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
+ https://en.cppreference.com/w/c/io +

+
-- cgit v1.2.3