strspn
(PHP 4, PHP 5, PHP 7, PHP 8)
strspn —
Возвращает длину участка в начале строки, которая полностью соответствует маске
Описание
Если параметры offset
и length
не указаны, то будет исследована вся строка string
.
Если они указаны, то эффект будет аналогичен вызову
strspn(substr($string, $offset, $length),
$characters)
(подробнее смотрите функцию substr).
Строка кода:
присвоит
2
переменной
$var,
поскольку «42» — начальный участок строки
string
,
который состоит только из символов «1234567890».
Список параметров
string
-
Исследуемая строка.
characters
-
Список из разрешённых символов.
offset
-
Позиция начала поиска в subject
.
Если offset
указан и неотрицателен,
то функция strspn() начнёт искать в строке
string
, начиная с позиции
offset
. Например, в
строке «abcdef
» символ с позицией
0
— «a
», символ
с позицией 2
—
«c
» и т. д.
Если offset
указали и его значение отрицательное,
функция strspn() начнёт поиск
в строке string
с позиции, которая отстаёт
на offset
символов с конца
string
.
length
-
Длина фрагмента строки string
для проверки.
Если параметр length
указали и значение аргумента неотрицательно,
функция проверит length
символов
с начала строки string
.
Если параметр length
указали и он отрицателен,
функция проверит строку string
начиная со стартовой позиции до позиции, которая отстаёт
на length
символов с конца строки
string
.
Возвращаемые значения
Функция возвращает длину первого участка строки string
,
который целиком состоит из символов characters
.
Замечание:
Когда смещение offset
указано, возвращаемая длина строки определяется
с этой позиции, а не с начала строки string
.
Примеры
Пример #1 Пример использования функции strspn()
<?php
// Проверяемая строка не начинается ни с одного сивола маски
var_dump(strspn("foo", "o"));
// Проверить два символа входной строки начиная со смещения 1
var_dump(strspn("foo", "o", 1, 2));
// Проверить один символ входной строки начиная со смещения 1
var_dump(strspn("foo", "o", 1, 1));
?>
Результат выполнения приведённого примера:
Примечания
Замечание:
Функция безопасна для обработки данных в двоичной форме.
Смотрите также
- strcspn() - Находит длину начального фрагмента строки, который не соответствует маске