stdio.h: C++输入输出操作

头文件：<stdio.h>、<cstdio>

1、通过“streams”来操作物理设备：如键盘、打印机、终端等。
2、流通过指针来连接“FILE”对象，三个自动创建的标准流：stdin, stdout 和 stderr。

指示信息：

1、错误指示：当流操作发生错误是置位，可以通过ferror函数检查，通过 clearerr, freopen 或者 rewind重置。
2、文件结束：读/写到文件结束时置位，可通过feof检查，通过 clearerr/freopen 或者重定位函数（rewind, fseek and fsetpos）置位。
3、位置指示：在读/写操作中，指向流的下一个字符的内部指针。可以通过 ftell and fgetpos获得其值，通过 rewind, fseek and fsetpos 改变其值。

一、文件操作

1、int remove ( const char * filename );

param：filename，文件名（可以包含文件路径）
return：若成功，返回0；否则返回非零值

/* remove example: remove myfile.txt */
#include <stdio.h>int main ()
{if( remove( "myfile.txt" ) != 0 )perror( "Error deleting file" );elseputs( "File successfully deleted" );return 0;
}

2、int rename ( const char * oldname, const char * newname );

param:oldname,原文件名（可以包含文件路径）; newname,新文件名（可以包含文件路径）
return:成功重命名，返回0；否则返回非零。

/* rename example */
#include <stdio.h>int main ()
{int result;char oldname[] ="oldname.txt";char newname[] ="newname.txt";result= rename( oldname , newname );if ( result == 0 )puts ( "File successfully renamed" );elseperror( "Error renaming file" );return 0;
}

3、FILE * tmpfile ( void );

创建一个临时的二进制文件。自动创建，当流关闭时删除。
ret:指向临时文件的流指针；失败返回NULL。

/* tmpfile example */
#include <stdio.h>
#include <string.h>int main ()
{char buffer [256];FILE * pFile;pFile = tmpfile ();do {if (!fgets(buffer,256,stdin)) break;  //临时缓冲文件流fputs (buffer,pFile);} while (strlen(buffer)>1);rewind(pFile);while (!feof(pFile)) {if (fgets (buffer,256,pFile) == NULL) break;fputs (buffer,stdout);}fclose (pFile);return 0;
}

4、char * tmpnam ( char * str );

返回一个文件名（与原来所有文件不同）。
如果str是空指针，返回的字符串存储在静态数组中，可用返回值取得。

如果str不是空指针，将指向至少 L_tmpnam字符的数组，次数组用提到的临时文件名填充

para:指向字符数组的指针，此字符以C-字符串存储临时文件名。
ret:成功，返回指向字符串的指针；如果str为NULL，返回指向内部缓存的指针。失败，返回NULL。

/* tmpnam example */
#include <stdio.h>int main ()
{char buffer [L_tmpnam];char * pointer;tmpnam (buffer);printf ("Tempname #1: %s\n",buffer);pointer = tmpnam (NULL);printf ("Tempname #2: %s\n",pointer);return 0;
}

二、文件访问

1、int fclose ( FILE * stream );

描述：关闭文件。成功，返回0；失败，返回EOF。

2、int fflush ( FILE * stream );

描述：文件等待更新（读/写），文件将在输出操作后、输入操作前更新。成功，返回0；失败，返回EOF。

/* fflush example */
#include <stdio.h>
char mybuffer[80];
int main()
{FILE * pFile;pFile = fopen ("example.txt","r+");if (pFile == NULL) perror ("Error opening file");else {fputs ("test",pFile);fflush (pFile);    // flushing or repositioning requiredfgets (mybuffer,80,pFile);puts (mybuffer);fclose (pFile);return 0;}
}

3、FILE * fopen ( const char * filename, const char * mode );

描述：

文件名（C-风格字符串），mode（r,w,a,r+,w+,a+）。

成功，返回指向文件的指针；失败，返回NULL。

4、FILE * freopen ( const char * filename, const char * mode, FILE * stream );

描述：

重新以新的文件名或模式打开流文件。

文件名改变，先关闭原文件，断开流定向；然后重定向流到新的文件。如果文件名为空，改变文件的模式。

如果文件成功重新打开，返回新文件流指针；否则，返回NULL。

/* freopen example: redirecting stdout */
#include <stdio.h>int main ()
{freopen ("myfile.txt","w",stdout);printf ("This sentence is redirected to a file.");fclose (stdout);return 0;
}

5、void setbuf ( FILE * stream, char * buffer );

描述：

流：打开的对象

buffer：使用者申请的buff，至少BUFSIZ bytes。

当文件流指向打开的文件，但无任何读/写操作时使用。

/* setbuf example */
#include <stdio.h>int main ()
{char buffer[BUFSIZ];FILE *pFile1, *pFile2;pFile1=fopen ("myfile1.txt","w");pFile2=fopen ("myfile2.txt","a");setbuf ( pFile1 , buffer );fputs ("This is sent to a buffered stream",pFile1);fflush (pFile1);setbuf ( pFile2 , NULL );fputs ("This is sent to an unbuffered stream",pFile2);fclose (pFile1);fclose (pFile2);return 0;
}

6、int setvbuf ( FILE * stream, char * buffer, int mode, size_t size );

描述：

改变流缓存，改变模式和大小。

如果buffer指针为空，自动申请buffer。

/* setvbuf example */
#include <stdio.h>int main ()
{ FILE *pFile;pFile=fopen ("myfile.txt","w");setvbuf ( pFile , NULL , _IOFBF , 1024 );// File operations herefclose (pFile);return 0;
}

三、格式化输入输出

四、字符输入输出

五、直接输入输出

1、size_t fread ( void * ptr, size_t size, size_t count, FILE * stream );

描述：

从流中读取数据块。

读取count元素，每个元素大小为size bytes，从stream保存到内存块ptr。

返回值：成功读取的元素数目。

/* fread example: read an entire file */
#include <stdio.h>
#include <stdlib.h>int main () {FILE * pFile;long lSize;char * buffer;size_t result;pFile = fopen ( "myfile.bin" , "rb" );if (pFile==NULL) {fputs ("File error",stderr); exit (1);}// obtain file size:fseek (pFile , 0 , SEEK_END);lSize = ftell (pFile);rewind (pFile);// allocate memory to contain the whole file:buffer = (char*) malloc (sizeof(char)*lSize);if (buffer == NULL) {fputs ("Memory error",stderr); exit (2);}// copy the file into the buffer:result = fread (buffer,1,lSize,pFile);if (result != lSize) {fputs ("Reading error",stderr); exit (3);}/* the whole file is now loaded in the memory buffer. */// terminatefclose (pFile);free (buffer);return 0;
}

2、size_t fwrite ( const void * ptr, size_t size, size_t count, FILE * stream );

描述：写块数据到流。

写count元素，每个元素大小为size bytes，从内存块ptrstream到stream。

返回值：成功写的元素数目。

/* fwrite example : write buffer */
#include <stdio.h>int main ()
{FILE * pFile;char buffer[] = { 'x' , 'y' , 'z' };pFile = fopen ("myfile.bin", "wb");fwrite (buffer , sizeof(char), sizeof(buffer), pFile);fclose (pFile);return 0;
}

六、文件定位

1、int fgetpos ( FILE * stream, fpos_t * pos );

描述：

在流中取回当前的位置。

成功，返回0；失败，返回非0.

/* fgetpos example */
#include <stdio.h>
int main ()
{FILE * pFile;int c;int n;fpos_t pos;pFile = fopen ("myfile.txt","r");if (pFile==NULL) perror ("Error opening file");else{c = fgetc (pFile);printf ("1st character is %c\n",c);fgetpos (pFile,&pos);for (n=0;n<3;n++){fsetpos (pFile,&pos);c = fgetc (pFile);printf ("2nd character is %c\n",c);}fclose (pFile);}return 0;
}

2、int fseek ( FILE * stream, long int offset, int origin );

重定位流的位置。

offset：从origin开始的字节数。

origin：位置。（SEEK_SET SEEK_CUR SEEK_END）

成功，返回0；失败，返回非0.

如果读/写错误，设置ferror。

/* fseek example */
#include <stdio.h>int main ()
{FILE * pFile;pFile = fopen ( "example.txt" , "wb" );fputs ( "This is an apple." , pFile );fseek ( pFile , 9 , SEEK_SET );fputs ( " sam" , pFile );fclose ( pFile );return 0;
}

3、int fsetpos ( FILE * stream, const fpos_t * pos );

重新存储流的当前位置到pos。成功，返回0；失败，返回非0。

/* fsetpos example */
#include <stdio.h>int main ()
{FILE * pFile;fpos_t position;pFile = fopen ("myfile.txt","w");fgetpos (pFile, &position);fputs ("That is a sample",pFile);fsetpos (pFile, &position);fputs ("This",pFile);fclose (pFile);return 0;
}

4、long int ftell ( FILE * stream );

成功，返回当前的位置。失败，返回-1L。

得到流中当前的位置。

/* ftell example : getting size of a file */
#include <stdio.h>int main ()
{FILE * pFile;long size;pFile = fopen ("myfile.txt","rb");if (pFile==NULL) perror ("Error opening file");else{fseek (pFile, 0, SEEK_END);   // non-portablesize=ftell (pFile);fclose (pFile);printf ("Size of myfile.txt: %ld bytes.\n",size);}return 0;
}

5、void rewind ( FILE * stream );

设置流的位置到begging。

七、异常处理

1、void clearerr ( FILE * stream );

重置error和eof标志。

2、int feof ( FILE * stream );

检查eof标志。

eof置位，返回非零。否则，返回0。

3、int ferror ( FILE * stream );

检查error标志。

4、void perror ( const char * str );

打印错误信息。

八、宏常量

BUFSIZ：缓存大小EOF：文件结尾FILENAME_MAX：文件名的最大长度FOPEN_MAX：同时打开流的极限值L_tmpnam：临时文件名的最小长度NULL：空指针TMP_MAX：临时文件最大数量

九、类型

FILE：控制流的对象fpos_t：文件中的特定位置对象size_t：无符号整型

十、对象

stderr：标准错误流，FILE * stderr;stdin：标准输入流，FILE * stdin;stdout：标准输出流，FILE * stdout;