(PHP 4, PHP 5, PHP 7)
strtok — Разбивает строку на токены
Описание
$str
, string $token
)$token
)strtok() разбивает строку str
на подстроки (токены), используя в качестве разделителей символы из token
. Например, строку «This is an example string» можно разбить на отдельные слова используя пробел в качестве разделителя.
Заметьте, что исходная строка передается только при первом вызове этой функции. Последующим вызовам передаются только разделители, так как эта функция сохраняет исходную строку и запоминает позицию в этой строке между вызовами. Для работы с новой строкой нужно снова вызвать функцию с двумя аргументами. Обратите внимание, что в параметре token можно использовать несколько разделителей. Строка будет делиться по любому найденному символу, присутствующему в этом параметре.
Список параметров
str
-
Строка (string), разбиваемая на подстроки (токены).
token
-
Разделитель строки
str
.
Возвращаемые значения
Токен (string).
Примеры
Пример #1 Пример использования strtok()
<?php $string = "This is\tan example\nstring"; /* В качестве разделителей используем пробел, табуляцию и перевод строки */ $tok = strtok($string, " \n\t"); while ($tok !== false) { echo "Word=$tok<br />"; $tok = strtok(" \n\t"); } ?>
Пример #2 Способ обработки пустых подстрок функцией strtok()
<?php $first_token = strtok('/something', '/'); $second_token = strtok('/'); var_dump($first_token, $second_token); ?>
Результат выполнения данного примера:
string(9) "something" bool(false)
Примечания
Эта функция может возвращать как boolean FALSE
, так и не-boolean значение, которое приводится к FALSE
. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.