定義和用法

fgets() 函數(shù)從文件指針中讀取一行。

語法

fgets(file,length)

參數(shù)	描述
file	必需。規(guī)定要讀取的文件。
length	可選。規(guī)定要讀取的字節(jié)數(shù)。默認(rèn)是 1024 字節(jié)。

說明

從 file 指向的文件中讀取一行并返回長度最多為 length - 1 字節(jié)的字符串。碰到換行符（包括在返回值中）、EOF 或者已經(jīng)讀取了 length - 1 字節(jié)后停止（要看先碰到那一種情況）。如果沒有指定 length，則默認(rèn)為 1K，或者說 1024 字節(jié)。

若失敗，則返回 false。

提示和注釋

注釋：length 參數(shù)從 PHP 4.2.0 起成為可選項(xiàng)，如果忽略，則行的長度被假定為 1024 字節(jié)。從 PHP 4.3 開始，忽略掉 length 將繼續(xù)從流中讀取數(shù)據(jù)直到行結(jié)束。如果文件中的大多數(shù)行都大于 8 KB，則在腳本中指定最大行的長度在利用資源上更為有效。

注釋：從 PHP 4.3 開始本函數(shù)可以安全用于二進(jìn)制文件。早期的版本則不行。

注釋：如果碰到 PHP 在讀取文件時(shí)不能識(shí)別 Macintosh 文件的行結(jié)束符，可以激活 auto_detect_line_endings 運(yùn)行時(shí)配置選項(xiàng)。

例子

例子 1

<?php

$file = fopen("test.txt","r");
echo fgets($file);
fclose($file);

?> 

輸出類似：

Hello, this is a test file.

例子 2

<?php

$file = fopen("test.txt","r");

while(! feof($file))
  {
  echo fgets($file). "<br />";
  }

fclose($file);
?>

輸出類似：

Hello, this is a test file. 
There are three lines here. 
This is the last line.