ctype_alpha

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

ctype_alpha — Check for alphabetic character(s)

Опис

ctype_alpha(mixed $text): bool

Checks if all of the characters in the provided string, text, are alphabetic. In the standard C locale letters are just [A-Za-z] and ctype_alpha() is equivalent to (ctype_upper($text) || ctype_lower($text)) if $text is just a single character, but other languages have letters that are considered neither upper nor lower case.

Параметри

text

The tested string.

Зауваження:
Ціле число (int) від -128 до 255 включно вважається кодом символу ASCII (від'ємні значення збільшуються на 256, що дає доступ до розширеного діапазону ASCII). Інші цілі числа вважаються рядками, що містять ціле десяткове число у вигляді цифр.

Увага

Починаючи з PHP 8.1.0, параметр, що не є рядком — застарів. У майбутньому параметр вважатиметься виключно рядком, а не кодом символу з ASCII. Залежно від наміченої поведінки, параметр буде або приведено до string, або явно опрацьовано функцією chr().

Значення, що повертаються

Returns true if every character in text is a letter from the current locale, false otherwise. Якщо викликано з порожнім рядком — результатом буде false.

Приклади

Приклад #1 A ctype_alpha() example (using the default locale)

<?php
$strings = array('KjgWZC', 'arf12');
foreach ($strings as $testcase) {
    if (ctype_alpha($testcase)) {
        echo "The string $testcase consists of all letters.\n";
    } else {
        echo "The string $testcase does not consist of all letters.\n";
    }
}
?>

Поданий вище приклад виведе:

The string KjgWZC consists of all letters.
The string arf12 does not consist of all letters.

Прогляньте також

ctype_upper() - Check for uppercase character(s)
ctype_lower() - Check for lowercase character(s)
setlocale() - Set locale information
IntlChar::isalpha() - Check if code point is a letter character