PHP | fgets 函数
Lasted 2021-01-01 12:29:46
fgets 函数从文件指针中读取一行。
fgets() 函数接收两个参数,其中文件指针为必填项。函数返回读取的字符串,如果遇到错误或者没有更多数据返回 false。
函数定义
fgets ( resource $handle [, int $length ] ) : string
// 源文件位于:ext/standard/file.c
# 函数定义
PHPAPI PHP_FUNCTION(fgets)
{
...
if (len_is_null) {
/* ask streams to give us a buffer of an appropriate size */
buf = php_stream_get_line(stream, NULL, 0, &line_len);
if (buf == NULL) {
RETURN_FALSE;
}
// TODO: avoid reallocation ???
RETVAL_STRINGL(buf, line_len);
efree(buf);
} else {
if (len <= 0) {
zend_argument_value_error(2, "must be greater than 0");
RETURN_THROWS();
}
str = zend_string_alloc(len, 0);
if (php_stream_get_line(stream, ZSTR_VAL(str), len, &line_len) == NULL) {
zend_string_efree(str);
RETURN_FALSE;
}
/* resize buffer if it's much larger than the result.
* Only needed if the user requested a buffer size. */
if (line_len < (size_t)len / 2) {
str = zend_string_truncate(str, line_len, 0);
} else {
ZSTR_LEN(str) = line_len;
}
RETURN_NEW_STR(str);
}
}
参数
- checkhandle - 文件指针。文件指针必须有效,并且是通过 fopen() 或 fsockopen() 函数成功打开的文件(并还未由 fclose() 关闭)。
- checklength - 取回该长度的数据。可选参数。
返回值
- checkstring - 从指针 handle 指向的文件中读取 length - 1 字节后返回字符串。错误或者文件结尾返回 false。
示例1: - 使用 fgets() 函数从文件指针中读取一行。
<?php
/**
* PHP 使用 fgets() 函数从文件指针中读取一行。
*
* @since Version 1.0.0
* @filesource
*/
// 打开文件
$handle = fopen('foo.txt', 'r');
// 按行读取文件
if ($handle) {
while (($line = fgets($handle)) !== false) {
}
// 检测文件是否到结尾,防止异常终止
if (!feof($handle)) {
echo "Error: unexpected fgets() fail\n";
}
// 关闭文件
fclose($handle);
}