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() - Возвращает длину участка в начале строки, полностью соответствующего маске