(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
sscanf — Разбирает строку в соответствии с заданным форматом
Функция sscanf() похожа на функцию
printf(), но используется не для вывода, а для
ввода данных. sscanf() интерпретирует строку
string
в соответствии с форматом
format
.
Любые пробельные символы в строке формата соответствуют любым
пробельным символам во входной строке. Это значит, что, например,
символ табуляции (\t
) в строке формата соответствует символу пробела во
входной строке.
string
Обрабатываемая строка (string).
format
Интерпретируемый формат для параметра string
,
который описан в документации функции sprintf()
со следующими отличиями:
F
, g
, G
и
b
.
D
обозначает десятичное число.
i
обозначает целое число с определением системы счисления.
n
обозначает количество символов, обработанных на данный момент.
s
останавливает чтение на любом символе пробела.
*
вместо argnum$
подавляет
присвоение данной спецификации преобразования.
vars
Необязательные переменные, передаваемые по ссылке, которым будут присвоены считанные значения.
Если переданы только эти два аргумента, будет возвращён массив. В противном случае, считанные из строки значения будут присвоены переменным, переданным через дополнительные аргументы, и будет возвращено количество присвоенных значений. Дополнительные аргументы должны передаваться по ссылке.
Если ожидается больше подстрок в параметре format
,
чем доступно в параметре str
,
то будет возвращено значение 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";
?>