fget用法详解

以下来自百度百科：

    从文件结构体指针stream中读取数据，每次读取一行。读取的数据保存在buf指向的字符数组中，每次最多读取bufsize-1个字符（第bufsize个字符赋'\0'），如果文件中的该行，不足bufsize个字符，则读完该行就结束。如若该行（包括最后一个换行符）的字符数超过bufsize-1，则fgets只返回一个不完整的行，但是，缓冲区总是以NULL字符结尾，对fgets的下一次调用会继续读该行。函数成功将返回buf，失败或读到文件结尾返回NULL。因此我们不能直接通过fgets的返回值来判断函数是否是出错而终止的，应该借助feof函数或者ferror函数来判断。

   

函数原型

char *fgets(char *buf, int bufsize, FILE *stream);

参数

*buf: 字符型指针，指向用来存储所得数据的地址。

bufsize: 整型数据，指明存储数据的大小。

*stream: 文件结构体指针，将要读取的文件流。

返回值

1. 成功，则返回第一个参数buf；
2. 在读字符时遇到 end-of-file，则eof指示器被设置，如果还没读入任何字符就遇到这种情况，则buf保持原来的内容，返回NULL；
3. 如果发生读入错误，error指示器被设置，返回NULL，buf的值可能被改变。 ^[1]  

功能

注意1：《UNIX 环境高级编程》中指出，每次调用fgets函数会造成标准输出设备自动刷清！案例详见《UNIX环境高级编程（第二版）》中程序清单1-5和课后习题5.7，习题5.7的答案中给出了相关的论述。

注意2：初入门者，大多数是在WINDOWS下，使用VS进行练习的。此环境下，对注意1中的情况进行测试，并不能看到案例中所描述的情景，因为具体的实现不同。

stream文件流指针体指向文件内容地址的偏移原则

如果使用fgets()读取某个文件，第一次读取的bufsize为5，而文件的第一行有10个字符（算上'\n'），那么读取文件的指针会偏移至当前读取完的这个字符之后的位置。也就是第二次再用fgets()读取文件的时候，则会继续读取其后的字符。而，如果使用fgets() 读取文件的时候bufsize大于该行的字符总数加2（多出来的两个，一个保存文件本身的'\n'换行，一个保存字符串本身的结束标识'\0'），文件并不会继续读下去，仅仅只是这一行读取完，随后指向文件的指针会自动偏移至下一行。

例：

如果一个文件的当前位置的文本如下

Love, I Have

Since you can do it.

如果用fgets(str1,6,file1);去读取

则执行后str1 = "Love," ，读取了6-1=5个 字符

这个时候再执行fgets(str1,20,file1)则执行后str1 = " I Have\n"

而如果

fgets(str1,23,file1);

则执行str1="Love ,I Have"，读取了一行(包括行尾的'\n',并自动加上字符串结束符'\0')，当前文件位置移至下一行，虽然23大于当前行上字符总和，可是不会继续到下一行。而下一次调用fgets()继续读取的时候是从下一行开始读。

序例

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21

#include<string.h> #include<stdio.h>   int  main (  void  ) {      FILE *stream;      char  string[]= "Thisisatest" ;      char  msg[20]; /*openafileforupdate*/      stream= fopen ( "DUMMY.FIL" , "w+" ); /*writeastringintothefile*/      fwrite (string, strlen (string),1,stream); /*seektothestartofthefile*/      fseek (stream,0,SEEK_SET); /*readastringfromthefile*/      fgets (msg, strlen (string)+1,stream); /*displaythestring*/      printf ( "%s" ,msg);      fclose (stream);      return  0; }

fgets函数用来从文件中读入字符串。fgets函数的调用形式如下：fgets（str，n，fp）；此处，fp是 文件指针；str是存放在字符串的起始地址；n是一个int类型变量。函数的功能是从fp所指文件中读入n-1个字符放入str为起始地址的空间内；如果在未读满n-1个字符之时，已读到一个换行符或一个EOF（文件结束标志），则结束本次读操作，读入的字符串中最后包含读到的换行符。因此，确切地说，调用fgets函数时，最多只能读入n-1个字符。读入结束后，系统将自动在最后加'\0'，并以str作为函数值返回。

函数原型是：char *fgets(char *s, int n, FILE *stream);

<-------------------------------------------------------------------------->

来说一说fgets(..)函数。

    原型  char *  fgets(char * s, int n,FILE *stream);

    参数：

         s: 字符型指针，指向存储读入数据的缓冲区的地址。

         n: 从流中读入n-1个字符

         stream ： 指向读取的流。

   返回值：

          1. 当n<=0 时返回NULL，即空指针。

          2. 当n=1 时，返回空串"".

          3. 如果读入成功，则返回缓冲区的地址。

          4. 如果读入错误或遇到文件结尾(EOF)，则返回NULL.

1. /****************************************************  
2.  char *fgets(char *s, int n,  FILE *stream)  
3.    {  
4.      register int c;  
5.      register char *cs;  
6.      cs=s;  
7.      while(--n>0 &&(c = getc(stream))!=EOF)  
8.      if ((*cs++=  c) =='\n')  
9.            break;  
10.      *cs ='\0';  
11.      return (c == EOF && cs == s) ?NULL :s ;  
12.     }  
13.   
14. /********************************************************  

       在用fgets(..)读入数据时，先定义一个字符数组或字符指针，如果定义了字符指针 ，那么一定要初始化。

        example:

              char s[100]; //可以。

              char *s;  //不可以，因为只是声明了一个指针。但并没有为它分配内存缓冲区。

        所以，如果要用指针，则  char *s=(char *)malloc(100*sizeof(char)); 为其分配内存空间,c++中用char *s=new char [100];      如果为分配内存空间，编译时不会检查出问题，但运行时会出现未知错误。。

        fgets(...)读入文本行时的两种情况。

          1.如果n大于一行的字符串长度，那么当读到字符串末尾的换行符时，fgets(..)会返回。并且在s的最后插入字符串结束标志'\0'。 而s缓冲区剩余的位置不会再填充。

           example：

              123abc

              fgets(s,10,fp);

              此时，读入七个字符，123abc\n,实际上还有最后的'\0',所以，strlen(s)=7; 如果要去除末尾的\n，s[strlen(s)-1]='\0';便可。

          2.如果n小于等于一行的字符串的长度，那么读入n-1个字符，此时并没有读入\n因为并没有到行尾 ，同样在最后会插入'\0'.

          example:

            123abc

            char  s[5];

            fgets(s,5,fp);

            这时读入4个字符，123a,并没有换行符，所以strlen(s)=4.

       fgets(...)读入整个文件内容

          通常用while()循环来使fges()读入文本全部内容，并按行读入。

          

[cpp] view plain copy print ?

1. char s[1024];  
2.            while((fgets(s,1024,fp))!=NULL)  
3.             {  
4.                   printf(s);  
5.             }  

         当然如果n小于每行的字符个数，也可以读，只不过读的次数要多。

          假设一行为 ： 123456789

          

[cpp] view plain copy print ?

1. char s[2];  
2.           int  num=0;  
3.           while((fgets(s,2,fp))!=NULL)  
4.             {  
5.                  printf(s);  
6.                  n++;  
7.             }  

          每次读入一个字符， 最后也会读完一行，num=10，读了十次，所以，fgets若没遇到换行符，会接着从前一次的位置继续读入n-1个字符,只要是文本流没关闭。

         读入空行的情况：

            第一行   abcdef123

            第二行                       

            第三行  helloworld

            其中第二行为空，fget(..)会把第二行也读入，因为并未到文件结尾。

            有时我们并不需要空行，可以这样做。

          

[cpp] view plain copy print ?

1. while((fgets(s,n,fp))!=NULL)  
2.              {  
3.                   if(strlen(s)!=1)    //注意这儿是1不是0，因为尽管是空行，它也会读入换行符，strlen(s)=1;  
4.                       printf(s);  
5.              }  

         fgets(...)从标准设备读数据。

            用fgets(...)还也读入标准输入设备(一般为键盘)的信息

            原型  ：  fgets(s,n,stdin);

            假设在控制台下，我们可以用fgets(...)替代gets(),读入键盘输入的信息，fgets()是安全的，因为不会像gets()有溢出的可能。。

            比如 ：输入 abc

            fgets(s,n,stdin)也会读入n-1个字符。但是只是从stdin流读入。。。

1. /****************************************************  
2.  char *fgets(char *s, int n,  FILE *stream)  
3.    {  
4.      register int c;  
5.      register char *cs;  
6.      cs=s;  
7.      while(--n>0 &&(c = getc(stream))!=EOF)  
8.      if ((*cs++=  c) =='\n')  
9.            break;  
10.      *cs ='\0';  
11.      return (c == EOF && cs == s) ?NULL :s ;  
12.     }  
13.   
14. /********************************************************  

       在用fgets(..)读入数据时，先定义一个字符数组或字符指针，如果定义了字符指针 ，那么一定要初始化。

        example:

              char s[100]; //可以。

              char *s;  //不可以，因为只是声明了一个指针。但并没有为它分配内存缓冲区。

        所以，如果要用指针，则  char *s=(char *)malloc(100*sizeof(char)); 为其分配内存空间,c++中用char *s=new char [100];      如果为分配内存空间，编译时不会检查出问题，但运行时会出现未知错误。。

        fgets(...)读入文本行时的两种情况。

          1.如果n大于一行的字符串长度，那么当读到字符串末尾的换行符时，fgets(..)会返回。并且在s的最后插入字符串结束标志'\0'。 而s缓冲区剩余的位置不会再填充。

           example：

              123abc

              fgets(s,10,fp);

              此时，读入七个字符，123abc\n,实际上还有最后的'\0',所以，strlen(s)=7; 如果要去除末尾的\n，s[strlen(s)-1]='\0';便可。

          2.如果n小于等于一行的字符串的长度，那么读入n-1个字符，此时并没有读入\n因为并没有到行尾 ，同样在最后会插入'\0'.

          example:

            123abc

            char  s[5];

            fgets(s,5,fp);

            这时读入4个字符，123a,并没有换行符，所以strlen(s)=4.

       fgets(...)读入整个文件内容

          通常用while()循环来使fges()读入文本全部内容，并按行读入。

          

[cpp] view plain copy print ?

1. char s[1024];  
2.            while((fgets(s,1024,fp))!=NULL)  
3.             {  
4.                   printf(s);  
5.             }  

         当然如果n小于每行的字符个数，也可以读，只不过读的次数要多。

          假设一行为 ： 123456789

          

[cpp] view plain copy print ?

1. char s[2];  
2.           int  num=0;  
3.           while((fgets(s,2,fp))!=NULL)  
4.             {  
5.                  printf(s);  
6.                  n++;  
7.             }  

          每次读入一个字符， 最后也会读完一行，num=10，读了十次，所以，fgets若没遇到换行符，会接着从前一次的位置继续读入n-1个字符,只要是文本流没关闭。

         读入空行的情况：

            第一行   abcdef123

            第二行                       

            第三行  helloworld

            其中第二行为空，fget(..)会把第二行也读入，因为并未到文件结尾。

            有时我们并不需要空行，可以这样做。

          

[cpp] view plain copy print ?

1. while((fgets(s,n,fp))!=NULL)  
2.              {  
3.                   if(strlen(s)!=1)    //注意这儿是1不是0，因为尽管是空行，它也会读入换行符，strlen(s)=1;  
4.                       printf(s);  
5.              }  

         fgets(...)从标准设备读数据。

            用fgets(...)还也读入标准输入设备(一般为键盘)的信息

            原型  ：  fgets(s,n,stdin);

            假设在控制台下，我们可以用fgets(...)替代gets(),读入键盘输入的信息，fgets()是安全的，因为不会像gets()有溢出的可能。。

            比如 ：输入 abc

            fgets(s,n,stdin)也会读入n-1个字符。但是只是从stdin流读入。。。