# C 库函数 - fgets() ## 描述 C 库函数 **char *fgets(char *str, int n, FILE *stream)** 从指定的流 stream 读取一行，并把它存储在 **str** 所指向的字符串内。当读取 **(n-1)** 个字符时，或者读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。 ## 声明 下面是 fgets() 函数的声明。 ``` char *fgets(char *str, int n, FILE *stream) ``` ## 参数 * **str** -- 这是指向一个字符数组的指针，该数组存储了要读取的字符串。 * **n** -- 这是要读取的最大字符数（包括最后的空字符）。通常是使用以 str 传递的数组长度。 * **stream** -- 这是指向 FILE 对象的指针，该 FILE 对象标识了要从中读取字符的流。 ## 返回值 如果成功，该函数返回相同的 str 参数。如果到达文件末尾或者没有读取到任何字符，str 的内容保持不变，并返回一个空指针。 如果发生错误，返回一个空指针。 ## 实例 下面的实例演示了 fgets() 函数的用法。 ``` #include <stdio.h> int main() { FILE *fp; char str[60]; /* 打开用于读取的文件 */ fp = fopen("file.txt" , "r"); if(fp == NULL) { perror("打开文件时发生错误"); return(-1); } if( fgets (str, 60, fp)!=NULL ) { /* 向标准输出 stdout 写入内容 */ puts(str); } fclose(fp); return(0); } ``` 假设我们有一个文本文件 **file.txt**，它的内容如下。文件将作为实例中的输入： ``` We are in 2014 ``` 让我们编译并运行上面的程序，这将产生以下结果： ``` We are in 2014 ```