PHP 8.4.1 Released!

ctype_upper

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

ctype_upperПроверяет символы в верхнем регистре

Описание

ctype_upper(mixed $text): bool

Проверяет, состоит ли переданная строка (string) text только из букв в верхнем регистре.

Список параметров

text

Проверяемая строка.

Замечание:

Если передано целое число (int) в диапазоне между -128 и 255 включительно, то оно будет обработано как ASCII-код одного символа (к отрицательным значениям будет прибавлено 256, чтобы функция могла представить символы из расширенного диапазона ASCII). Остальные целые числа будут обработаны как строки, содержащие десятичные цифры целых чисел.

Внимание

Начиная с PHP 8.1.0 передача нестроковых аргументов устарела. В будущем аргумент вместо ASCII-кода будет интерпретироваться как строка. В зависимости от предполагаемого поведения аргумент либо преобразовывают в строку (string), либо вызывают функцию chr().

Возвращаемые значения

Возвращает true, если каждый символ в строке text — это прописная буква из установленного языкового стандарта (локали). При вызове с пустой строкой результатом всегда будет false.

Примеры

Пример #1 Пример использования функция ctype_upper() (с выбором локали по умолчанию)

<?php

$strings
= array('AKLWC139', 'LMNSDO', 'akwSKWsm');
foreach (
$strings as $testcase) {
if (
ctype_upper($testcase)) {
echo
"Строка $testcase состоит только из букв в верхнем регистре.\n";
} else {
echo
"Строка $testcase не состоит только из букв в верхнем регистре.\n";
}
}
?>

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

Строка AKLWC139 не состоит только из букв в верхнем регистре.
Строка LMNSDO состоит только из букв в верхнем регистре.
Строка akwSKWsm не состоит только из букв в верхнем регистре.

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

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

Добавить

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

up
6
chris at theothernews dot co dot nz
10 years ago
Underscores in the string will result in false, so you have to remove them first.
To Top