TheC programming language provides manystandard libraryfunctions forfileinput and output. These functions make up the bulk of theC standard libraryheader<stdio.h>.^[1] The functionality descends from a "portable I/O package" written byMike Lesk atBell Labs in the early 1970s,^[2] and officially became part of theUnix operating system inVersion 7.^[3]

The I/O functionality of C is fairly low-level by modern standards; C abstracts all file operations into operations onstreams ofbytes, which may be "input streams" or "output streams". Unlike some earlier programming languages, C has no direct support forrandom-access data files; to read from a record in the middle of a file, the programmer must create a stream,seek to the middle of the file, and then read bytes in sequence from the stream.

The stream model of file I/O was popularized by Unix, which was developed concurrently with the C programming language itself. The vast majority of modern operating systems have inherited streams from Unix, and many languages in theC programming language family have inherited C's file I/O interface with few if any changes (for example,PHP).

This library uses what are called streams to operate with physical devices such as keyboards, printers, terminals or with any other type of files supported by the system. Streams are an abstraction to interact with these in a uniform way. All streams have similar properties independent of the individual characteristics of the physical media they are associated with.^[4]

Most of the C file input/output functions are defined in<stdio.h> (or in theC++ headercstdio, which contains the standard C functionality but in thestdnamespace).

Constants defined in the<stdio.h> header include:

Variables defined in the<stdio.h> header include:

Data types defined in the<stdio.h> header include:

• FILE – also known as afilehandle or aFILE pointer, this is anopaque pointer containing the information about a file or text stream needed to perform input or output operations on it, including:
  • platform-specific identifier of the associated I/O device, such as afile descriptor
  • the buffer
  • stream orientation indicator (unset, narrow, or wide)
  • stream buffering state indicator (unbuffered, line buffered, fully buffered)
  • I/O mode indicator (input stream, output stream, or update stream)
  • binary/text mode indicator
  • end-of-file indicator
  • error indicator
  • the current stream position and multibyte conversion state (an object of type mbstate_t)
  • reentrant lock (required as ofC11)
• fpos_t – a non-array type capable of uniquely identifying the position of every byte in a file and every conversion state that can occur in all supported multibyte character encodings
• size_t – anunsigned integer type which is the type of the result of thesizeof operator.

ThePOSIX standard defines several extensions tostdio in its Base Definitions, among which are areadline function that allocates memory, thefileno andfdopen functions that establish the link betweenFILE objects andfile descriptors, and a group of functions for creatingFILE objects that refer to in-memory buffers.^[5]

The following C program opens a binary file calledmyfile, reads five bytes from it, and then closes the file.

#include<stdio.h>#include<stdlib.h>intmain(void){charbuffer[5];FILE*fp=fopen("myfile","rb");if(fp==NULL){perror("Failed to open file\"myfile\"");returnEXIT_FAILURE;}if(fread(buffer,1,5,fp)<5){fclose(fp);fputs("An error occurred while reading the file.\n",stderr);returnEXIT_FAILURE;}fclose(fp);printf("The bytes read were: ");for(inti=0;i<5;++i){printf("%02X ",buffer[i]);}putchar('\n');returnEXIT_SUCCESS;}

Several alternatives tostdio have been developed. Among these is theC++iostream library, part of theISO C++ standard. ISO C++ still requires thestdio functionality.

Other alternatives include the Sfio^[6] (A Safe/Fast I/O Library) library fromAT&T Bell Laboratories. This library, introduced in 1991, aimed to avoid inconsistencies, unsafe practices and inefficiencies in the design ofstdio. Among its features is the possibility to insertcallback functions into a stream to customize the handling of data read from or written to the stream.^[7] It was released to the outside world in 1997, and the last release was 1 February 2005.^[8]

• printf format string
• scanf format string

The WikibookC Programming has a page on the topic of:C Programming/C Reference

• Media related toC file input/output at Wikimedia Commons

• C standard library
• Input/output

• CS1 maint: bot: original URL status unknown
• Articles with short description
• Short description matches Wikidata
• Use dmy dates from February 2022
• Commons category link from Wikidata
• Articles with example C code