array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'splfileobject.fscanf.php', 1 => 'SplFileObject::fscanf', 2 => 'Разбирает входные данные из файла по условиям формата', ), 'up' => array ( 0 => 'class.splfileobject.php', 1 => 'SplFileObject', ), 'prev' => array ( 0 => 'splfileobject.fread.php', 1 => 'SplFileObject::fread', ), 'next' => array ( 0 => 'splfileobject.fseek.php', 1 => 'SplFileObject::fseek', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/spl/splfileobject/fscanf.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

SplFileObject::fscanf

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

SplFileObject::fscanf — Разбирает входные данные из файла по условиям формата

Описание

public SplFileObject::fscanf(string $format, mixed &...$vars): array|int|null

Метод считывает строку из файла и интерпретирует её по условиям формата format.

Любые пробельный символ в строке format соответствует любому пробельный символу в строке из файла. Это означает, что даже символ табуляции (\t) в строке формата может соответствовать одному пробелу в строке файла.

Список параметров

format

Формат интерпретации строки string, который описывает документация к функции sprintf() со следующими отличиями:

  • Функция не учитывает языковые настройки.
  • Параметр не поддерживает флаги F, g, G и b.
  • Флаг D обозначает десятичное число.
  • Флаг i обозначает целое число с определением системы счисления.
  • Флаг n обозначает количество символов, которые функция уже обработала.
  • Флаг s останавливает чтение при любом пробельном символе.
  • Символ * вместо спецификатора преобразования argnum$ подавляет присваивание этого спецификатора преобразования.

vars

Необязательные переменные, которым функция присвоит значения.

Возвращаемые значения

Метод возвращает массив с результатами разбора, если передали только один аргумент. Метод вернёт количество присвоенных значений, если передали необязательные аргументы. Необязательные аргументы требуется передавать по ссылке.

Примеры

Пример #1 Пример использования метода SplFileObject::fscanf()

<?php

$file = new SplFileObject("misc.txt");

while ($userinfo = $file->fscanf("%s %s %s")) {
list ($name, $profession, $countrycode) = $userinfo;
// Работаем с переменными $name, $profession и $countrycode
}

?>

Содержимое файла users.txt

javier   argonaut    pe
hiroshi  sculptor    jp
robert   slacker     us
luigi    florist     it

Смотрите также