(PHP 4, PHP 5, PHP 7)
strcspn — Возвращает длину участка в начале строки, не соответствующего маске
$subject
, string $mask
[, int $start
[, int $length
]] ) : int
Возвращает длину участка в начале строки subject, который
не содержит ни одного символа из строки
mask.
Если параметры start и length
не указаны, то все содержимое subject будет исследовано.
Если же эти параметры указаны, то эффект будет таким же, как при вызове
strcspn(substr($subject, $start, $length), $mask)
(см. substr для дополнительной информации).
subjectСтрока для исследования.
maskСтрока, содержащая каждый из запрещенных символов.
start
Позиция в строке subject, с которой начинается поиск.
Если start указан и не является отрицательным значением,
тогда strcspn() начнет обследование строки
subject с позиции, указанной в start.
Например: в строке 'abcdef', символ в позиции 0 это
'a', символ в позиции 2 это 'c',
и так далее.
Если start указан, но является отрицательным числом,
то strspn() начнет обследование строки
subject с позиции, указанной в параметре
start, начиная с конца строки subject.
length
Длина фрагмента из subject для обследования.
Если параметр length указан
и не является отрицательным значением, тогда
будет обследовано length
символов из subject, отсчитывая от
стартовой позиции.
Если length передан и значение отрицательное,
то будут проверяться символы, начиная со стартовой позиции и до
length
с конца subject.
Возвращает длину начального фрагмента строки subject, которая
состоит полностью из символов, не включенных в параметр mask.
Замечание:
Когда параметр
startуказан, возвращаемая длина определяется, начиная с этой позиции, а не с начала строкиsubject.
Пример #1 Пример использования strcspn()
<?php
$a = strcspn('abcd', 'apple');
$b = strcspn('abcd', 'banana');
$c = strcspn('hello', 'l');
$d = strcspn('hello', 'world');
$e = strcspn('abcdhelloabcd', 'abcd', -9);
$f = strcspn('abcdhelloabcd', 'abcd', -9, -5);
var_dump($a);
var_dump($b);
var_dump($c);
var_dump($d);
var_dump($e);
var_dump($f);
?>
Результат выполнения данного примера:
int(0) int(0) int(2) int(2) int(5) int(4)
Замечание: Эта функция безопасна для обработки данных в двоичной форме.