函数名:stream_get_line()
适用版本:PHP 4 >= 4.3.0, PHP 5, PHP 7
函数描述:stream_get_line() 函数从文件指针中读取一行内容,并返回该行内容。
用法: stream_get_line(resource $handle, int $length, string $ending = ?): string|false
参数:
- $handle:必需,表示文件指针的资源。通常使用 fopen() 函数打开文件后得到的资源。
- $length:必需,表示要读取的最大字节数。如果遇到换行符或达到最大字节数时,读取将停止。
- $ending:可选,表示行结束符。默认为 "\n"。可以使用多个字符作为行结束符。
返回值:
- 返回读取的行内容,如果到达文件结尾则返回 false。
示例:
$handle = fopen("example.txt", "r");
if ($handle) {
$line = stream_get_line($handle, 1024, "\n");
echo $line;
fclose($handle);
}
在上面的示例中,我们打开了一个名为 "example.txt" 的文件,然后使用 stream_get_line() 函数从文件指针中读取一行内容,并将其存储在变量 $line 中。最后,我们将该行内容输出到屏幕上。
请注意,如果文件指针到达文件结尾或读取的字节数达到了指定的最大字节数,stream_get_line() 函数将停止读取,并返回 false。因此,在实际应用中,我们需要根据返回值来判断是否成功读取到了一行内容。