ctype_alpha
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
ctype_alpha — Перевіряє літерні символи
Опис
ctype_alpha(mixed $text): bool
Перевіряє, чи передано рядок (string) text тільки з літер. У стандартній локалі мови Сі літерами визнаються лише символи, що входять до діапазону [A-Za-z], а функцияctype_alpha() еквівалентна виклику (ctype_upper($text) || ctype_lower($text)), якщо значення $text складається з одного символу, але в інших мовах є літери, які не визнаються ні верхнім, ні нижнім регістром.
Список параметрів
text
Перевірений рядок.
Зауваження :
Якщо передано ціле число (int) в діапазоні між -128 і 255 включно, воно буде оброблено як ASCII-код одного символу (до негативних значень буде додано 256, щоб функція могла представити символи з розширеного діапазону ASCII). Інші цілі числа будуть оброблені як рядки, що містять десяткові цифри цілих чисел.
Увага
Починаючи з PHP 8.1.0, передача нерядкових аргументів застаріла. У майбутньому аргумент замість ASCII-коду інтерпретуватиметься як рядок. Залежно від передбачуваної поведінки аргумент або перетворюють у рядок (string), або викликають функцію chr()
Значення, що повертаються
Повертає true, якщо кожен символ у рядку text - літера з поточного мовного стандарту (локалі), інакше false. При виклику з порожнім рядком результатом завжди буде false
Приклади
Приклад #1 Приклад використання функції ctype_alpha()** (з вибором локалі за замовчуванням)**
Результат виконання наведеного прикладу:
Строка KjgWZC состоит только из букв.
Строка arf12 состоит не только из букв.
Дивіться також
- ctype_upper() - Перевіряє символи у верхньому регістрі
- ctype_lower() - Перевіряє символи у нижньому регістрі
- setlocale() - Встановлює налаштування локалі
- IntlChar::isalpha() - Перевірити, чи є символ літерою