PHP Manual
Функции для работы со строками
Возвращает длину участка в начале строки, не соответствующего маске

strcspn

(PHP 4, PHP 5, PHP 7)

strcspn — Возвращает длину участка в начале строки, не соответствующего маске

Описание

strcspn ( string $string , string $characters , int $offset = 0 , int|null $length = null ) : int

Возвращает длину участка в начале строки string, который не содержит ни одного символа из строки characters.

Если параметры offset и length не указаны, то все содержимое string будет исследовано. Если же эти параметры указаны, то эффект будет таким же, как при вызове strcspn(substr($subject, $start, $length), $mask) (см. 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)

Примечания

Замечание: Эта функция безопасна для обработки данных в двоичной форме.

Смотрите также

strspn() - Возвращает длину участка в начале строки, полностью соответствующего маске