stream_get_line 函数

适用PHP版本

PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8

函数说明

stream_get_line() 函数从文件指针中读取一行数据，直到遇到指定的分隔符或文件结束。它可以用于逐行读取文件或流的内容，通常用于读取文本文件。

函数语法

string stream_get_line(resource $handle, int $length, string $delimiter = "\n")

参数

• $handle (resource): 必需。文件句柄，必须是通过 fopen() 或 fsockopen() 打开的流资源。
• $length (int): 必需。要读取的最大字节数。如果读取到的内容少于这个长度，读取会停止。
• $delimiter (string, 可选): 分隔符，默认是换行符 "\n"。当遇到该字符时，读取会停止。

返回值

返回读取到的字符串，如果到达流的结尾或发生错误，则返回 false。

示例

以下是使用 stream_get_line() 读取文件的一行内容的示例：

示例代码

<?php
$handle = fopen("example.txt", "r"); // 打开文件
if ($handle) {
    // 读取文件的第一行，分隔符为换行符
    $line = stream_get_line($handle, 1024, "\n");
    echo $line;
    fclose($handle); // 关闭文件句柄
}
?>
  

示例代码说明

该示例首先打开名为 example.txt 的文件并获取文件句柄。然后，它使用 stream_get_line() 从文件中读取一行，最多读取 1024 个字符，直到遇到换行符为止。最后，关闭文件句柄。