CascadiaPHP 2024

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() (с выбором локали по умолчанию)

<?php

$strings
= array('KjgWZC', 'arf12');
foreach (
$strings as $testcase) {
if (
ctype_alpha($testcase)) {
echo
"Строка $testcase состоит только из букв.\n";
} else {
echo
"Строка $testcase состоит не только из букв.\n";
}
}
?>

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

Строка KjgWZC состоит только из букв.
Строка arf12 состоит не только из букв.

Смотрите также

  • ctype_upper() - Проверяет символы в верхнем регистре
  • ctype_lower() - Проверяет символы в нижнем регистре
  • setlocale() - Устанавливает региональные настройки
  • IntlChar::isalpha() - Проверить, является ли символ буквой

add a note

User Contributed Notes 1 note

up
-49
Tyrunur
15 years ago
It works if you set the locale correctly:

<?php

setLocale
(LC_CTYPE, 'FR_fr.UTF-8');

?>

with this change you will get "yes" "yes"
To Top