array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.sscanf.php', 1 => 'sscanf', 2 => 'Разбирает строку по условиям формата', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Функции для работы со строками', ), 'prev' => array ( 0 => 'function.sprintf.php', 1 => 'sprintf', ), 'next' => array ( 0 => 'function.str-contains.php', 1 => 'str_contains', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/strings/functions/sscanf.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sscanf

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

sscanf — Разбирает строку по условиям формата

Описание

sscanf(string $string, string $format, mixed &...$vars): array|int|null

Функция sscanf() — аналог функции printf() для входных данных. Функция sscanf() сканирует строку string и интерпретирует строку по условиям формата format.

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

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

string

Входная строка (string) для разбора.

format

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

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

vars

Необязательные переменные, которые передаются по ссылке и которые будут содержать значения с результатами разбора строки.

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

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

Если параметр format ожидает больше подстрок, чем доступно в параметре string, вернётся значение null.

Примеры

Пример #1 Пример использования функции sscanf()

<?php

// Получаем серийный номер
list($serial) = sscanf("SN/2350001", "SN/%d");

// и дату изготовления
$mandate = "January 01 2000";

list($month, $day, $year) = sscanf($mandate, "%s %d %d");

echo "Узел $serial изготовили: $year-" . substr($month, 0, 3) . "-$day\n";

?>

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

Пример #2 Пример использования функции sscanf() с необязательными аргументами

<?php

// Получаем имя автора и формируем запись в формате DocBook
$auth = "24\tLewis Carroll";

$n = sscanf($auth, "%d\t%s %s", $id, $first, $last);

echo "<author id='$id'>
<firstname>$first</firstname>
<surname>$last</surname>
</author>\n";

?>

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