(PHP 4, PHP 5, PHP 7, PHP 8)
strcspn — Возвращает длину участка в начале строки, не соответствующего маске
$string
,$characters
,$offset
= 0,$length
= null
Возвращает длину участка в начале строки string
, который
не содержит ни одного символа из строки
characters
.
Если параметры offset
и length
не указаны, то все содержимое string
будет исследовано.
Если же эти параметры указаны, то эффект будет таким же, как при вызове
strcspn(substr($string, $offset, $length),
$characters)
(смотрите substr для дополнительной информации).
string
Строка для исследования.
characters
Строка, содержащая каждый из запрещённых символов.
offset
Позиция в строке string
, с которой начинается поиск.
Если offset
указан и не является отрицательным значением,
тогда strcspn() начнёт обследование строки
string
с позиции, указанной в offset
.
Например: в строке 'abcdef
', символ в позиции 0
это
'a
', символ в позиции 2
это 'c
',
и так далее.
Если offset
указан, но является отрицательным числом,
то strspn() начнёт обследование строки
string
с позиции, указанной в параметре
offset
, начиная с конца строки string
.
length
Длина фрагмента из string
для обследования.
Если параметр length
указан
и не является отрицательным значением, тогда
будет обследовано length
символов из string
, отсчитывая от
стартовой позиции.
Если length
передан и значение отрицательное,
то будут проверяться символы, начиная со стартовой позиции и до
length
с конца string
.
Возвращает длину начального фрагмента строки string
, которая
состоит полностью из символов, не включённых в параметр characters
.
Замечание:
Когда параметр
offset
указан, возвращаемая длина определяется, начиная с этой позиции, а не с начала строкиstring
.
Версия | Описание |
---|---|
8.0.0 |
length теперь допускает значение null.
|
Пример #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)
Замечание: Эта функция безопасна для обработки данных в двоичной форме.