strspn
(PHP 4, PHP 5, PHP 7, PHP 8)
strspn — Повертає довжину ділянки на початку рядка, що повністю відповідає масці
Опис
strspn( string $string, string $characters, int $offset = 0, ?int $length = null): int
Повертає довжину ділянки від початку рядка string, содержащийтільки символи з characters
Якщо параметри offsetиlength не вказано, то буде досліджено весь рядок string. Якщо вони вказані, то ефект буде аналогічним виклику strspn(substr($string, $offset, $length), $characters)(подробнее смотрите функциюsubstr
Рядок коду:
присвоїть змінної $var, тому що "42" - це початкова ділянка рядка string, Що складається тільки з символів "1234567890".
Список параметрів
string
Досліджуваний рядок.
characters
Список із дозволених символів.
offset
Позиция начала поиска вsubject
Якщо offset вказаний і невід'ємний, то strspn() почне шукати у рядку string, починаючи з позиції offset. . Наприклад, у рядку 'abcdef', символ з позиції є 'a', символ з позиції є 'c' і т.д.
Якщо offset вказаний і негативний, то strspn() почне пошук у рядку string з позиції, що віддаляється на offset символів з кінця string
length
Длина исследуемого фрагментаstring
Якщо length вказаний і невід'ємний, то рядок stringбудет исследована в течениеlengthпосле стартовой позиции.
Якщо length вказаний і негативний, то рядок string буде досліджено починаючи зі стартової позиції до позиції, що віддаляється на length символів з кінця string
Значення, що повертаються
Возвращает длину первого участкаstring, що складається цілком із символів у characters
Зауваження :
Когда
offsetвказано, довжина рядка, що повертається, визначається, починаючи з цієї позиції, а не з початку рядкаstring
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | length тепер допускає значення null. |
Приклади
Приклад #1 Приклад використання strspn()****
Результат виконання наведеного прикладу:
int(0)
int(2)
int(1)
Примітки
Зауваження: Ця функція безпечна для обробки даних у двійковій формі.
Дивіться також
- strcspn() - Повертає довжину ділянки на початку рядка, що не відповідає масці