array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.fscanf.php', 1 => 'fscanf', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.fread.php', 1 => 'fread', ), 'next' => array ( 0 => 'function.fseek.php', 1 => 'fseek', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/fscanf.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
fscanf — Обрабатывает данные из файла в соответствии с форматом
Функция fscanf() похожа на
sscanf(), но берёт данные для обработки из файла,
связанного с stream
, и интерпретирует их
согласно формату format
.
Любой пробельный символ в строке формата эквивалентен любому
пробельному символу во входящем потоке. Это означает, что даже табуляция
(\t
) в строке формата может быть сопоставлена
одному символу пробела во входящем потоке данных.
Каждый вызов fscanf() читает одну строку из файла.
stream
Ресурс (resource) указателя файловой системы, который часто создают функцией fopen().
format
Интерпретируемый формат для параметра string
,
который описан в документации функции sprintf()
со следующими отличиями:
F
, g
, G
и
b
.
D
обозначает десятичное число.
i
обозначает целое число с определением системы счисления.
n
обозначает количество символов, обработанных на текущий момент.
s
останавливает чтение на любом символе пробела.
*
вместо argnum$
подавляет
присвоение данной спецификации преобразования.
vars
Необязательные присваиваемые значения.
Если в функцию переданы только два аргумента, обработанные значения будут возвращены в виде массива. В ином случае, если были переданы необязательные аргументы, функция вернёт количество присвоенных значений. Необязательные аргументы должны быть переданы по ссылке.
Если в format
ожидается больше подстрок,
чем доступно в string
, будет возвращён null
.
В случае возникновения других ошибок будет возвращено false
.
Пример #1 Пример использования функции fscanf()
<?php
$handle = fopen("users.txt", "r");
while ($userinfo = fscanf($handle, "%s\t%s\t%s\n")) {
list ($name, $profession, $countrycode) = $userinfo;
//... совершаем какие-либо действия над значениями
}
fclose($handle);
?>
Пример #2 Содержимое файла users.txt
javier argonaut pe hiroshi sculptor jp robert slacker us luigi florist it