C language file operation functions

Source: Internet
Author: User
Tags fread rewind

Clearerr (error flag for clearing file streams)
Feof
Header file # include <stdio. h>
Define the void clearerr (File * stream) function );
Function Description clearerr () clears the error flag used by the file stream specified by the stream parameter.
Return Value

Fclose (close file)
Related functions close, fflush, fopen, setbuf
Header file # include <stdio. h>
Defines the function int fclose (File * stream );
Function Description: fclose () is used to close files opened by fopen. This action writes data in the buffer zone to a file and releases the file resources provided by the system.
If the object is successfully closed, 0 is returned. If an error occurs, EOF is returned and the ErrorCodeSave to errno.
The error code ebadf indicates that the parameter stream is not an open file.
For more information, see fopen ().

Fdopen (convert file description to file pointer)
Related functions: fopen, open, and fclose
Header file # include <stdio. h>
Define the function file * fdopen (INT Fildes, const char * mode );
Function Description fdopen () converts the file description of Fildes to the corresponding file pointer and returns the result. The mode string represents the stream format of the file pointer, which must be the same as the read/write mode of the original file description. For more information about the mode string format, see fopen ().
If the return value is converted successfully, the file pointer pointing to the stream is returned. If the Error Code fails, null is returned, and the error code is stored in errno.
Example
# Include <stdio. h>
Main ()
{
File * fp = fdopen (0, "W + ");
Fprintf (FP, "% s \ n", "hello !");
Fclose (FP );
}

Execute hello!

feof (check whether the file stream has read the end Of the file)
related functions: fopen, fgetc, fgets, fread
header file # include
define the int feof (File * stream) function.
Function Description: feof () is used to detect whether the end of the file is read. The ending stream is fopen () the Object Pointer returned. If the end of the file is reached, a non-zero value is returned. Otherwise, 0 is returned.
A non-zero value is returned, indicating that the object has reached the end of the object.
fflush (update buffer)
related functions: Write, fopen, fclose, and setbuf
header file # include
defines the int fflush (File * stream) function.
fflush () forces data in the buffer to be written back to the file specified by the parameter stream. If the parameter stream is null, fflush () updates all open file data.
If the return value is successful, 0 is returned. If the return value is failed, EOF is returned. The error code is stored in errno.
the file specified by the error code "stream" is not opened, or the file is in read-only status. For other error codes, see write ().
fgetc (one character read from the file)
related functions: open, fread, fscanf, GETC
header file include
define the function nt fgetc (File * stream);
Function Description: fgetc () reads a character from the file indicated by the parameter stream. If you read the end Of the file without data, the EOF is returned.
the returned value GETC () returns the read characters. If EOF is returned, it indicates the end of the file.
example
# include
main ()
{< br> file * FP;
int C;
fp = fopen ("exist ", "R");
while (C = fgetc (FP ))! = EOF)
printf ("% C", c);
fclose (FP);
}

Fgets (read a string from the file)
Related functions: open, fread, fscanf, GETC
Header file include <stdio. h>
Define the function Har * fgets (char * s, int size, file * stream );
Function Description: fgets () is used to read characters from the file referred to by the parameter stream to the memory space referred to by the parameter S, until a line break occurs, the end of the file is read, or the size-1 character is read, null is added as the string.
If gets () is returned successfully, the S pointer is returned. If null is returned, an error occurs.
Example
# Include <stdio. h>
Main ()
{
Char s [80];
Fputs (fgets (s, 80, stdin), stdout );
}

Run this is a test/* input */
This is a test/* output */


Fileno (returns the file description used by the file Stream)
Related functions: open and fopen
Header file # include <stdio. h>
Defines the int fileno (File * stream) function );
Function Description: fileno () is used to obtain the file description used by the file stream specified by the parameter stream.
The Return Value Returns the description of the file.
Example
# Include <stdio. h>
Main ()
{
File * FP;
Int FD;
Fp = fopen ("/etc/passwd", "R ");
FD = fileno (FP );
Printf ("FD = % d \ n", FD );
Fclose (FP );
}

Execute FD = 3


fopen (Open File)
related functions: open and fclose
header file # include
define the function file * fopen (const char * path, const char * mode);
Function Description: the path string contains the file path and file name to be opened, the mode string represents the stream format.
mode has the following forms of strings:
r: to open a read-only file, the file must exist.
r + open a readable and writable file, which must exist.
W open and write-only files. If the file exists, the file length is 0, indicating that the file content will disappear. If the file does not exist, the file is created.
W + open the readable and writable file. If the file exists, the file length is cleared to zero, meaning that the file content disappears. If the file does not exist, the file is created.
A opens and writes only files as an attachment. If the file does not exist, the file will be created. If the file exists, the written data will be added to the end of the file, that is, the original content of the file will be retained.
A + opens readable and writable files by appending them. If the file does not exist, the file will be created. If the file exists, the written data will be added to the end of the file, that is, the original content of the file will be retained.
the preceding morphological strings can be added with a B character, such as a combination of Rb, W + B, and AB +. The B character is added to indicate that the file opened by the function library is a binary file, rather than text files. However, this character is ignored in the POSIX System in Linux. The new file created by fopen () has the s_irusr | s_iwusr | s_irgrp | s_iwgrp | s_iroth | s_iwoth (0666) Permission. For the File Permission, see umask value.
when the returned value file is successfully opened, the file pointer pointing to the stream will be returned. If the file fails to be opened, null is returned and the error code is stored in errno.
Note: After opening a file, the file will be read or written. If opening the file fails, the subsequent read/write operations cannot proceed smoothly. Therefore, the fopen () then, make error judgment and handling.
example
# include
main ()
{< br> file * FP;
fp = fopen ("noexist", "A + ");
If (FP = NULL) return;
fclose (FP);
}

fputc (write a specified character to the file stream)
related functions: fopen, fwrite, fscanf, putc
header file # include
defines the int fputc (int c, file * stream) function.
function description fputc converts parameter C to unsigned char and writes it to the file specified by parameter stream.
If the returned value is fputc (), a successfully written character is returned, that is, parameter C. If EOF is returned, the write operation fails.
example
# include
main ()
{< br> file * FP;
char a [26] = "abcdefghijklmnopqrstuvwxyz";
int I;
fp = fopen ("noexist", "W");
for (I = 0; I <26; I ++)
fputc (, FP);
fclose (FP);
}

fputs (writing a specified string to a file)
related functions: fopen, fwrite, fscanf, fputc, putc
header file # include
define the int fputs (const char * s, file * stream) function.
Function Description: fputs () it is used to write the string referred to by parameter S into the file referred to by parameter stream.
If the return value is successful, the number of written characters is returned. If the return value is EOF, an error occurs.
For an example, see fgets ().
fread (reads data from a file stream)
related functions: fopen, fwrite, fseek, and fscanf
header file # include
define the size_t fread (void * PTR, size_t size, size_t nmemb, file * stream) function.
function description fread () used to read data from a file stream. The stream parameter is an opened file pointer. the PTR parameter points to the data space to be read. The number of characters read is determined by the size * nmemb parameter. Fread () returns the number of nmemb actually read. If this value is smaller than the nmemb parameter, it indicates that the file may be read at the end or an error occurs. In this case, feof () must be used () or ferror () to determine what happens.
the returned value returns the number of nmemb instances actually read.
additional description
example
# include
# define nmemb 3
struct test
{< br> char name [20];
int size;
} s [nmemb];
int main () {
file * stream;
int I;
stream = fopen ("/tmp/fwrite", "R");
fread (S, sizeof (struct test), nmemb, stream );
fclose (Stream);
for (I = 0; I printf ("name [% d] = %-20 s: Size [% d] = % d \ n", I, S. name, I, S. size);
}

Run
Name [0] = Linux! Size [0] = 6
Name [1] = FreeBSD! Size [1] = 8
Name [2] = Windows2000 size [2] = 11


Freopen (open a file)
Related functions fopen and fclose
Header file # include <stdio. h>
Define the function file * freopen (const char * path, const char * mode, file * stream );
Function Description: the path string contains the path and file name of the file to be opened. For details about the mode parameter, see fopen. The stream parameter is an opened file pointer. Freopen () will close the file stream opened by the original stream, and then open the file with the path parameter.
When the returned value file is successfully opened, the file pointer pointing to the stream will be returned. If the file fails to be opened, null is returned and the error code is stored in errno.
Example
# Include <stdio. h>
Main ()
{
File * FP;
Fp = fopen ("/etc/passwd", "R ");
Fp = freopen ("/etc/group", "R", FP );
Fclose (FP );
}

Fseek (read/write location of a mobile file Stream)
Related functions: rewind, ftell, fgetpos, fsetpos, and lseek
Header file # include <stdio. h>
Defines the int fseek (File * stream, long offset, int whence) function );
Function Description: fseek () is used to move the read/write location of a file stream. The stream parameter is an opened file pointer, And the offset parameter is the number of read/write locations to be moved Based on the whence parameter.
The whence parameter is one of the following:
The offset displacement from the beginning of the seek_set file is the new read/write location. Seek_cur increases the offset displacement at the current read/write position.
Seek_end points the read/write position to the end of the file and then increases the offset displacement.
When the whence value is seek_cur or seek_end, the offset parameter allows negative values.
The following are special usage methods:
1) to move the read/write location to the beginning of the file: fseek (File * stream, 0, seek_set );
2) to move the read/write location to the end of the file: fseek (File * stream, 0, 0seek_end );
Return Value: if the call is successful, 0 is returned. If an error exists,-1 is returned. errno stores the error code.
Note that fseek () does not return the read/write location like lseek (). Therefore, ftell () must be used to obtain the current read/write location.
Example
# Include <stdio. h>
Main ()
{
File * stream;
Long offset;
Fpos_t Pos;
Stream = fopen ("/etc/passwd", "R ");
Fseek (stream, 5, seek_set );
Printf ("offset = % d \ n", ftell (Stream ));
Rewind (Stream );
Fgetpos (stream, & Pos );
Printf ("offset = % d \ n", POS );
Pos = 10;
Fsetpos (stream, & Pos );
Printf ("offset = % d \ n", ftell (Stream ));
Fclose (Stream );
}

Execute offset = 5
Offset = 0
Offset = 10


Ftell (get the reading location of the file stream)
Related functions: fseek, rewind, fgetpos, and fsetpos
Header file # include <stdio. h>
Defines the function long ftell (File * stream );
Function Description: ftell () is used to obtain the current read/write location of a file stream. The stream parameter is an opened file pointer.
Return Value: if the call is successful, the current read/write location is returned. If an error occurs,-1 is returned, and errno stores the error code.
Error code: file stream with invalid parameter stream or removable read/write location.
For an example, see fseek ().

Fwrite (write data to a file Stream)
Related functions: fopen, fread, fseek, and fscanf
Header file # include <stdio. h>
Define the function size_t fwrite (const void * PTR, size_t size, size_t nmemb, file * stream );
Function Description: fwrite () is used to write data to a file stream. The stream parameter is an opened file pointer. the PTR parameter points to the data address to be written. The total number of characters written is determined by the parameter size * nmemb. Fwrite () returns the number of nmemb actually written.
The Return Value Returns the number of nmemb actually written.
Example
# Include <stdio. h>
# Define set_s (x, y) {strcoy (s [X]. Name, Y); s [X]. size = strlen (y );}
# Define nmemb 3
Struct Test
{
Char name [20];
Int size;
} S [nmemb];
Main ()
{
File * stream;
Set_s (0, "Linux !");
Set_s (1, "FreeBSD !");
Set_s (2, "windows2000 .");
Stream = fopen ("/tmp/fwrite", "W ");
Fwrite (S, sizeof (struct test), nmemb, stream );
Fclose (Stream );
}

For execution instructions, see fread ().

GETC (one character read from the file)
Related functions: read, fopen, fread, fgetc
Header file # include <stdio. h>
Defines the int GETC (File * stream) function );
Function Description GETC () is used to read a character from the file indicated by the parameter stream. If you read the end Of the file without data, the EOF is returned. Although GETC () and fgetc () act the same way, GETC () is defined as a macro and is not a real function call.
If the returned value is GETC (), the read characters are returned. If the returned value is EOF, the returned values are at the end of the file.
For an example, see fgetc ().

Getchar (reads one character from the standard input device)
Related functions: fopen, fread, fscanf, GETC
Header file # include <stdio. h>
Define the function int getchar (void );
Function Description getchar () is used to read a character from the standard input device. Convert the character from unsigned char to int and return the result.
If the returned value is getchar (), the read characters are returned. If the returned value is EOF, an error occurs.
Additional descriptions getchar () is not a real function, but is defined by the GETC (stdin) Macro.
Example
# Include <stdio. h>
Main ()
{
File * FP;
Int C, I;
For (I = 0li <5; I ++)
{
C = getchar ();
Putchar (C );
}
}

Run the 1234/* input */
1234/* output */

gets (a string is read from the standard input device)
related functions: fopen, fread, fscanf, and fgets
header file # include
define the function char * gets (char * s).
Function Description: gets () is used to read characters from standard devices and coexist to the memory space specified by parameter S, until a line break occurs or the end of the file is read, and null is added as the string.
If gets () is returned successfully, the S pointer is returned. If null is returned, an error occurs.
Note: Because gets () cannot know the size of string s, it is easy to cause a buffer overflow security problem because it must end the input only when it encounters a line break or the end of the file. We recommend that you use fgets () instead.
For an example, see fgets ()
mktemp (generate a unique temporary file name)
tmpfile
header file # include
define the function char * mktemp (char * template).
the function description mktemp () is used to generate a unique temporary file name. The last six characters in the file name string referred to by the template parameter must be xxxxxx. The generated file name is returned by a string pointer.
when the returned value file is successfully opened, the file pointer pointing to the stream will be returned. If the file fails to be opened, null is returned and the error code is stored in errno.
additional instructions: the file name string referred to by the template parameter must be declared as an array, for example,
char template [] = "template-xxxxxx ";
the char * template = "template-xxxxxx" is unavailable.
example
# include
main ()
{< br> char template [] = "template-xxxxxx";
mktemp (Template );
printf ("template = % s \ n", template);
}


putc (write a specified character to a file)
related functions: fopen, fwrite, fscanf, fputc
header file # include
define the int putc (int c, file * stream) function.
Function Description: putc () convert parameter C to unsigned char and write it to the file specified by parameter stream. Although putc () works the same as fputc (), putc () is defined as a macro and is not a real function call.
If putc () is returned, a successfully written character is returned, that is, the parameter C. If EOF is returned, the write operation fails.
For an example, see fputc ().
putchar (writing specified characters to the standard output device)
related functions: fopen, fwrite, fscanf, fputc
header file # include
define the int putchar (INT c) function.
the putchar () function is used to write the C character of the parameter to the standard output device.
If putchar () is returned, a successful output character is returned, that is, parameter C. If EOF is returned, the output fails.
additional descriptions putchar () is not a real function, but is defined by the putc (C, stdout) Macro.
for an example, refer to getchar ().
rewind (resetting the file stream's read/write position to start with the file)
related functions: fseek, ftell, fgetpos, fsetpos
header file # include
define the void rewind (File * stream) function.
Function Description: rewind () is used to move the read/write location of the file stream to the beginning of the file. The stream parameter is an opened file pointer. This function is equivalent to calling fseek (stream, 0, seek_set ).
return value
example reference fseek ()

Setbuf (set the buffer of the file Stream)
Related functions: setbuffer, setlinebuf, and setvbuf
Header file # include <stdio. h>
Define the void setbuf function (File * stream, char * BUF );
Function Description: After opening the file stream and reading the content, call setbuf () to set the buffer zone of the file stream. The parameter stream is the specified file stream, and the parameter Buf points to the starting address of the custom buffer. If the Buf parameter is a null pointer, no buffer Io is required. Setbuf () is equivalent to calling: setvbuf (stream, Buf, Buf? _ Iofbf: _ ionbf, bufsiz)
Return Value

Setbuffer (set the buffer of the file Stream)
Related functions: setlinebuf, setbuf, and setvbuf
Header file # include <stdio. h>
Define the void setbuffer function (File * stream, char * Buf, size_t size );
Function Description: After opening the file stream and reading the content, call setbuffer () to set the buffer zone of the file stream. The parameter stream is the specified file stream. The parameter Buf points to the starting address of the custom buffer. The parameter size is the buffer size.
Return Value

Setlinebuf (set the file stream as a linear buffer)
Related functions: setbuffer, setbuf, and setvbuf
Header file # include <stdio. h>
Define the void setlinebuf (File * stream) function );
Function Description: setlinebuf () is used to set the file stream for non-buffered Io based on the behavior. Call: setvbuf (stream, (char *) null, _ iolbf, 0); see setvbuf ().
Return Value

Setvbuf (set the buffer of the file Stream)
Related functions: setbuffer, setlinebuf, and setbuf
Header file # include <stdio. h>
Defines the function int setvbuf (File * stream, char * Buf, int mode, size_t size );
Function Description: After opening the file stream and reading the content, call setvbuf () to set the buffer zone of the file stream. The parameter stream is the specified file stream. The parameter Buf points to the starting address of the custom buffer. The parameter size is the buffer size. The parameter mode has the following types:
_ Ionbf no buffer Io
_ Iolbf no buffer Io Based on Behavior Change
_ Iofbf has no buffer Io at all. If the Buf parameter is a null pointer, no buffer Io is required.
Return Value

Ungetc (write the specified character back to the file Stream)
Related functions: fputc, getchar, and GETC
Header file # include <stdio. h>
Defines the int ungetc (int c, file * stream) function );
Function Description: ungetc () writes the parameter C back to the file stream specified by the parameter stream. This write-back character is obtained by the next function that reads the file stream.
If the return value is successful, a C character is returned. If an error occurs, an EOF is returned.

This article from the csdn blog, reproduced please indicate the source: http://blog.csdn.net/qianwenhao/archive/2008/03/09/2160014.aspx

Contact Us

The content source of this page is from Internet, which doesn't represent Alibaba Cloud's opinion; products and services mentioned on that page don't have any relationship with Alibaba Cloud. If the content of the page makes you feel confusing, please write us an email, we will handle the problem within 5 days after receiving your email.

If you find any instances of plagiarism from the community, please send an email to: info-contact@alibabacloud.com and provide relevant evidence. A staff member will contact you within 5 working days.

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.