Linux C (streaming I/O)

Source: Internet
Author: User
Tags rewind types of functions

In ansi c, file operations are divided into two methods: stream file operations and I/O file operations, which are described below.

I. Stream File Operations

This file operation has an important structure file, which is defined in stdio. h as follows:

Typedef struct {

Int level;/* fill/empty level of buffer */

Unsigned flags;/* file Status flags */

Char FD;/* file descriptor */

Unsigned char hold;/* ungetc char if no buffer */

Int bsize;/* buffer size */

Unsigned char _ far * buffer;/* Data Transfer Buffer */

Unsigned char _ far * CURP;/* current active pointer */

Unsigned istemp;/* temporary file indicator */

Short token;/* used for validity checking */

} File;/* This is the file object */

The file structure contains the basic attributes of file operations. All file operations must be performed through the pointer of this structure. For common functions of such file operations, see the following table functions.

Fopen () Open stream

Fclose () Close the stream

Fputc () writes a character to the stream

Fgetc () reads a character from the stream

Fseek () locates the specified character in the stream

Fputs () writes a string to a stream

Fgets () reads a row or a specified character from the stream.

Fprintf () Outputs Data to the stream in the format

Fscanf () reads data from the stream in the format

Returns the true value when feof () reaches the end of a file.

Returns the value of ferror () When an error occurs.

Rewind () resets the file locator to the beginning of the file

Remove () delete an object

Fread () reads a specified number of characters from a stream

Fwrite () writes a specified number of characters to the stream.

Tmpfile () generates a temporary file stream

Tmpnam () generates a unique file name

The following describes these functions.

1. fopen ()

The fopen prototype is file * fopen (const char * filename, const char * mode). fopen implements three functions.

Open a stream for use; connect a file to the stream; return a filr pointer to the stream

The filename parameter points to the name of the file to be opened. mode indicates the string in the open state. The values are as follows:

"R" open files in read-only mode "W" open files in write-only mode "A" open files in append Mode

"R +" open a file in read/write mode. If no file error occurs, "W +" open the file in read/write mode. If no file is generated, a new file is generated.

A file can be opened in text or binary mode. The difference between the two is that in text mode, carriage return is treated as a character 'n ', the binary mode considers it to be two characters: 0x0d and 0x0a. If you read 0x1b in the file, the text mode considers it to be the file Terminator, that is, the binary model does not process the file, the text method converts the data in a certain way.

By default, the system is enabled in text mode. You can modify the value of all variables _ fmode to modify this setting. For example, _ fmode = o_text; then, the default mode is set to text mode; _ fmode = o_binary; the default enable mode is binary.

You can also specify the open mode in the mode string. For example, "rb" indicates that the read-only file is opened in binary mode, "W + t" or "WT +" indicates opening the read/write file in text mode.

This function returns a file pointer, so it does not need to be initialized after declaring a file pointer. Instead, it uses fopen () to return a pointer and connect it to a specific file. If it succeeds or fails, null is returned.

Example: file * FP;

If (FP = fopen ("123.456", "WB "))

Puts ("file opened successfully ");

Else

Puts ("file opening success or failure ");

2. The fclose () function is to disable files opened with fopen (). Its prototype is int fclose (File * FP). If the file is successful, 0 is returned, and EOF is returned if the file fails. When the program ends, remember to close the opened file. Otherwise, it may cause data loss. I used to make such a mistake.

3. fputc () writes a character to the stream. The prototype is int fputc (int c, file * stream). If the character is successfully returned, the EOF is returned. Example: fputc ('x', FP );

4. fgetc () reads a character from the stream. The prototype is int fputc (File * stream). If the character is successfully returned, the EOF is returned.

Example: Char struct = fgetc (FP );

5. fseek () this function is generally used in files opened in binary mode. It is used to locate the specified position in the stream. The prototype is int fseek (File * stream, long offset, int whence ); if 0 is returned successfully, the offset parameter indicates the number of characters to be moved, and the whence parameter indicates the moving benchmark. The value is

Symbol constant value reference position

Start with seek_set 0

Seek_cur 1 Current read/write location

Seek_end 2 file tail

Example: fseek (FP, 1234l, seek_cur); // move the read/write position 1234 bytes backward from the current position (L suffix indicates a long integer)

Fseek (FP, 0l, 2); // move the read/write location to the end of the file

6. fputs () writes a string to the stream. The prototype is int fputs (const char * s, file * stream );

Example: fputs ("I love you", FP );

7. fgets () reads a row or a specified character from the stream. The prototype is char * fgets (char * s, int N, file * stream). It reads n-1 characters from the stream, unless a row is read, the parameter S is used to receive strings. If the string is successful, the pointer of S is returned. Otherwise, null is returned.

For example, if the text at the current position of a file is as follows:

Love, I have

But ........

If fgets (str1, 4, file1) is used, str1 = "lov" is executed, and 4-1 = 3 characters are read. If fgets (str1, 23, file1 );

Run STR = "love, I have" to read a row (excluding 'n' at the end of the row ').

8. fprintf () is input to the stream in the format. Its prototype is int fprintf (File * stream, const char * Format [, argument,...]); the method is the same as printf (), but it is not written to the console, but to the stream. example: fprintf (FP, "% 2D % s", 4, "HAHAHA ");

9. fscanf () reads data from the stream in the format. Its prototype is int fscanf (File * stream, const char * Format [, address,...]); the method is the same as scanf (), but it is not read from the console, but from the stream. Example: fscanf (FP, "% d", & X, & Y );

10. Check whether feof () has reached the end of the file. If yes, return true. Otherwise, return 0. Its prototype is int feof (File * stream );

Example: If (feof (FP) printf ("ended at the end of the file ");

11. the prototype of ferror () is int ferror (File * stream). It returns the most recent error code of the stream and can be cleared by clearerr (). clearerr () the prototype is void clearerr (File * stream); for example, printf ("% d", ferror (FP ));

12. rewind () returns the current read/write location to the start of the file. The prototype is void rewind (File * stream). In fact, this function is equivalent to fseek (FP, 0l, seek_set). For example: rewind (FP );

12. Remove (): delete the file. The prototype is int remove (const char * filename). The parameter is the name of the file to be deleted, and 0 is returned.

Example: Remove ("C: Io. sys ");

13. fread () reads a specified number of characters from the stream. The prototype is size_t fread (void * PTR, size_t size, size_t N, file * stream). The PTR parameter stores the read data, void * pointers can be replaced by pointers of any type, such as char * and int *. Size indicates the number of bytes in each block. N indicates the number of read blocks. If yes, returns the number of actually read parts (not the number of bytes). This function is generally used in files opened in binary mode.

For example, char X [4230];

File * file1 = fopen ("C: msdos. sys", "R ");

Fread (x, 200, 12, file1); // read 2400*12 = bytes in total

14. fwrite () corresponds to fread and writes the specified data to the stream. The prototype is size_t fwrite (const void * PTR, size_t size, size_t N, file * stream ); the PTR parameter is the data pointer to be written. The Void * pointer can be replaced by any type of pointer, such as char * and int *. The size is the number of bytes per block; n is the number of blocks to be written. If the number of actually written blocks is returned (not the number of bytes), this function is generally used in files opened in binary mode.

For example, char X [] = "I Love You ";

Fwire (x, 6, 12, FP); // write 6*12 = 72 bytes

Write "I love" to the stream FP 12 times, a total of 72 bytes

15. the prototype of tmpfile () is file * tmpfile (void). Generate a temporary file, open it in "W + B" mode, and return the pointer to this temporary stream, if a failure occurs, null is returned. At the end of the program, the file will be automatically deleted. Example: file * fp = tmpfile ();

16. tmpnam (); its prototype is char * tmpnam (char * s); generate a unique file name. In fact, tmpfile () calls this function. parameter S is used to save the obtained file name, returns the pointer. If the pointer fails, null is returned. For example, tmpnam (str1 );

2. Direct I/O File Operations

This is another file operation provided by C. It processes the file by directly saving/retrieving the file, and the streaming file operation is carried out through the buffer; streaming file operations are performed around a file pointer, and such file operations are performed around a file's "handle". What is a handle? It is an integer that uniquely identifies a file (in windows, the handle concept is extended to the identifier of all device resources. Common functions for such file operations are listed in the following table. These functions and their symbols are defined in Io. h and fcntl. H, and corresponding header files must be added for use.

Function Description

Open () open a file and return its handle

Close () close a handle

Lseek () locates at the specified position of the file

Read () block Read File

Write () block Write File

Whether the EOF () test file is complete

Filelength () gets the file length

Rename () rename a file

Chsize () changes the file length

The following describes these functions:

1. open () open a file and return its handle. If it fails, a value smaller than 0 will be returned. The prototype is int open (const char * path, int access [, unsigned mode]); the path parameter is the name of the file to open, access is the mode to open, and mode is optional. This parameter indicates the properties of a file. It is mainly used in UNIX systems and has no significance in DOS/windows. The file opening mode is shown in the following table.

Symbol Meaning symbol meaning

O_rdonly read-only mode o_wronly write-only mode o_rdwr read/write mode

O_ndelay is used to append o_creat to o_creat in the Unix system. If the file does not exist, it is created.

O_trunc cut the file length to 0 o_excl and o_creat. If the file has an error, the o_binary binary method is returned.

O_text text

You can use the "|" operator to connect to multiple requirements. For example, o_append | o_text indicates opening a file in text mode and append mode.

Example: int handle = open ("C: msdos. sys", o_binary | o_creat | o_write)

2. Close () closes a handle. The prototype is int close (INT handle). If it is successful, 0 is returned. Example: Close (handle)

3. lseek () locates at the specified position. The prototype is long lseek (INT handle, long offset, int fromwhere). The offset parameter is the moving amount, and fromwhere is the moving reference position, the value is the same as fseek (). seek_set: File Header, seek_cur: Current Position of the file, and seek_end: End of the file. This function returns the new file access location after execution.

For example, lseek (handle,-1234l, seek_cur); // moves the access position 1234 bytes forward from the current position.

X = lseek (hnd1, 0l, seek_end); // move the access location to the end of the file. x = The End of the file, that is, the length of the file.

4. Read () reads a piece from a file. The prototype is int read (INT handle, void * Buf, unsigned Len). The parameter Buf stores the read data, and Len is the read byte. The function returns the bytes actually read. Example: Char X [200]; read (hnd1, X, 200 );

5. write () writes a piece of data to the file. The prototype is int write (INT handle, void * Buf, unsigned Len). The parameter meaning is the same as read (), and the actual written bytes are returned. Example: Char X [] = "I Love You"; write (handle, X, strlen (x ));

7. EOF () is similar to feof (). If the test file ends, 1 is returned; otherwise, 0 is returned. The prototype is int EOF (INT handle );

Example: While (! EOF (handle1 )){......};

8. filelength () returns the object length. The prototype is long filelength (INT handle). It is equivalent to lseek (handle, 0l, seek_end)

Example: long x = filelength (handle );

9. Rename () Rename the file. The prototype is int Rename (const char * oldname, const char * newname). The oldname parameter is the old file name, And newname is the new file name. 0 is returned. Example: Rename ("C: config. sys", "C: config. w40 ");

10. chsize (); change the file length. The prototype is int chsize (INT handle, Long SIZE). The parameter size indicates the new length of the file. If yes, 0 is returned. Otherwise,-1 is returned, if the specified length is smaller than the file length, the file is truncated. If the specified length is greater than the file length, add ''after the file ''.

Example: chsize (handle, 0x12345 );

If you are familiar with assembly, you may find that this method is similar to the handler file operation called by the DOS Function of the assembly language. For example, open () is like the 3ch function call of the DOS service, in fact, there are two types of functions that can be directly completed using DOS functions, such as _ open () and _ dos_open. If you are interested, you can query the help of BCB.

Same as streaming file operations, this also provides Unicode Character operation functions, such as _ wopen (), for wide character programming in 9x/NT, if you are interested, you can query the help of BCB.

In addition, this operation also includes functions such as lock (), unlock (), and locking () for multi-user operations, but it is not used much in BCB, so I will not introduce it, however, if you want to use C to write CGI, this is the common sense. If you have such requirements, you have to look at your own help.

 

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.