(PHP 4, PHP 5, PHP 7, PHP 8)
strcspn — Находит длину участка в начале строки, который не соответствует маске
Функция возвращает длину начального сегмента строки 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)
Замечание: Эта функция безопасна для обработки данных в двоичной форме.