c file input/output

In C programming, the fopen function is one of the basic functions in the stdio.h file of the C standard library. It returns an I/O stream attached to the specified file or other device from which reading and writing can be done. If the function fails, it returns 0. Because the functionality is so useful, many languages derived from C provide functions of the same name, with the same or similar function: for example, PHP. fopen is considered higher-level than the open system call of UNIX operating systems. The related C library function freopen performs the same operation after first closing any open stream associated with its parameter.

They are defined as

FILE *fopen(const char *path, const char *mode);

FILE *fdopen(int fildes, const char *mode);

FILE *freopen(const char *path, const char *mode, FILE *stream);

The fdopen function is not standard in C89 or C99, but is an extension used in POSIX environments and imitated elsewhere.

The mode parameter is a string that begins with one of the following sequences:

mode			description	starts..
r	rb		open for reading	beginning
w	wb		open for writing (creates file if it doesn't exist). Deletes content and overwrites the file.	beginning
a	ab		open for appending (creates file if it doesn't exist)	end
r+	rb+	r+b	open for reading and writing	beginning
w+	wb+	w+b	open for reading and writing. Deletes content and overwrites the file.	beginning
a+	ab+	a+b	open for reading and writing (append if file exists)	end

The 'b' stands for binary. The C standard gives two kinds of files - text files and binary files - although operating systems may or may not distinguish between the two. A text file is a file consisting of text arranged in lines with some sort of distinguishing end-of-line character or sequence (in Unix, a bare linefeed character; in the Macintosh OS, a bare carriage return; on DOS and Microsoft Windows, a carriage return followed by a linefeed). When bytes are read in from a text file, an end-of-line sequence is usually mapped to a linefeed for ease in processing. When a text file is written to, a bare linefeed is mapped to the OS-specific end-of-line character sequence before writing. A binary file is a file where bytes are read in "raw," and delivered "raw," without any kind of mapping.

When a file is opened with update mode ( '+' as the second or third character in the mode argument), both input and output may be performed on the associated stream. However, writes cannot be followed by reads without an intervening call to fflush() or to a file positioning function ( fseek(), fsetpos(), or rewind()), and reads cannot be followed by writes without an intervening call to a file positioning function. [1]

Writing and appending modes will create a file to write to in the case that the file name doesn't already exist. However, the operation of fopen is undefined if the filename doesn't follow requirements by the OS. For example, if the filename contains illegal characters , the program might crash. For example, in windows \ /: * ? < > and | cannot be part of a file name.

A convenient, but non-standard, way to find the length of a file in C is:

 #include <stdio.h>
 
 int main(void) 
 {
   long length;
   FILE *f = fopen("filename", "r");
   
   fseek(f, 0L, SEEK_END);
   length = ftell(f);
   rewind(f); /* Return to the beginning of the file for future useage */

   fclose(f);
   printf("%ld\n", length);
   
   return 0;
 }

c file input/output

See also