strcspn

(PHP 4, PHP 5, PHP 7, PHP 8)

strcspn — Повертає довжину ділянки на початку рядка, що не відповідає масці

Опис

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

Повертає довжину ділянки на початку рядка string, Котрий не містить жодного символу з рядка characters

Якщо параметри offsetиlength не вказано, то весь вміст string буде досліджено. Якщо ці параметри вказані, то ефект буде таким самим, як при виклику strcspn(substr($string, $offset, $length), $characters)(смотритеsubstr для додаткової інформації).

Список параметрів

string

Рядок для дослідження.

characters

Рядок, що містить кожен із заборонених символів.

offset

Позиция в строкеstring, З якої починається пошук.

Якщо offset вказано і не є негативним значенням, тоді strcspn() почне обстеження рядка string з позиції, зазначеної в offset. . Наприклад: у рядку 'abcdef', символ у позиції це 'a', символ у позиції це '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()****

Loading...
▶

Результат виконання наведеного прикладу:

int(0)
int(0)
int(2)
int(2)
int(5)
int(4)

Примітки

Зауваження: Ця функція безпечна для обробки даних у двійковій формі.

Дивіться також

• strspn() - Повертає довжину ділянки на початку рядка, що повністю відповідає масці