strtok
(PHP 4, PHP 5, PHP 7)
strtok — Разбивает строку на токены
Описание
$str
, string $token
) : string$token
) : string
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)
Примечания
Эта функция может возвращать как логическое значение false
, так и значение не типа boolean, которое приводится к false
. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.