fgets() - C語言庫函數

C庫函數 char *fgets(char *str, int n, FILE *stream) 讀取從指定的流一行，並將其存儲到由str指向的字符串。停止時，無論第（n-1）個字符讀取，讀取換行符，或達到最終文件，以先到者為準。

聲明

以下是聲明 fgets() 函數。

char *fgets(char *str, int n, FILE *stream)

參數

str -- 這是字符串讀取存儲的字符數組的指針。
n -- 這是最大的被讀取的字符數（包括最後的空字符）。通常情況下，通過使用str是數組的長度。
stream -- 這是一個文件對象標識流中讀取字符的指針。

返回值

成功，該函數返回的str參數相同。如果遇到任何字符被讀取完的文件，str的內容保持不變，並返回一個空指針。

如果發生錯誤，則返回空指針。

例子

下麵的例子顯示的使用fgets() 函數。

#include <stdio.h>

int main()
{
   FILE *fp;
   char str[60];

   /* opening file for reading */
   fp = fopen("file.txt" , "r");
   if(fp == NULL) {
      perror("Error opening file");
      return(-1);
   }
   if( fgets (str, 60, fp)!=NULL ) {
      /* writing content to stdout */
      puts(str);
   }
   fclose(fp);
   
   return(0);
}

假設我們有一個文本文件 file.txt，它具有以下的內容。此文件將被作為我們的示例程序輸入：

This is Tutorials Yiibai

讓我們編譯和運行上麵的程序，這將產生以下結果：

This is Tutorials Yiibai