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

# ctype_upper

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

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

### Описание

function ctype_upper(mixed `$text`): bool

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

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

`text`

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open