C语言fgets()函数（以指定长度读取文件中的字符，并存入字符数组变量中）

C语言fgets()函数（以指定长度读取文件中的字符，并存入字符数组变量中）

需要引入C 标准库 - <stdio.h>

描述

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

测试（第二个参数n，确实每次最大只能读n-1个字符）

test.txt

abcdefghijklmn

main.cpp

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main()
{
    FILE* fp;
    char str[60];
    fopen_s(&fp ,"test.txt", "r");
    if (fp == NULL) {
        perror("打开文件时发生错误");
        return(-1);
    }
    fgets(str, 6, fp);
    printf("%s\n", str);
    return(0);
}

运行结果：

abcde

参考文章：C 库函数 - fgets()

20220601 注意第二个参数n的上限值为sizeof(buffer)

第二个参数是每次读取的字节长度，不能超过缓冲区（第一个参数str）的大小，所以一般建议直接设为sizeof(buffer)

#pragma warning(disable : 4996)
#include<iostream>
#include<string>
using namespace std;

int main() {
	FILE* fp = fopen("test.txt", "r");
	char line[2] = { 0 };
	//fgets(line, 10, fp);
	while (fgets(line, sizeof(line), fp))
	{
		printf("%s\n", line);
	}
	return 0;
}

运行结果：

a
b
c
d
e
f
g