PHP 8.4.2 Released!

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) как ASCII-значение одного символа, если передали целое число в диапазоне между -128 и 255 включительно; к отрицательным значениям добавляется 256, чтобы разрешить символы из диапазона кодировки Extended 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() - Проверяет, относится ли кодовая точка к символам букв

Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы
To Top