Verifica se os caracteres são maiúsculos

# ctype_upper

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

ctype_upper — Verifica se os caracteres são maiúsculos

### Descrição

function ctype_upper(mixed `$text`): bool

Verifica se todos os caracteres na string fornecida, `text`, são maiúsculos.

### Parâmetros

`text`

  A string a ser testada.

  > Nota: Se um int entre -128 e 255 inclusive for fornecido, ele será interpretado como o valor ASCII de um único caractere (valores negativos são somados a 256 para permitir caracteres no intervalo ASCII estendido). Qualquer outro inteiro será interpretado como uma string contendo os dígitos decimais do inteiro.

  Aviso

  A partir do PHP 8.1.0, passar um argumento que não seja string foi descontinuado. No futuro, o argumento será interpretado como uma string em vez de um ponto de código ASCII. Dependendo do comportamento esperado, o argumento deve ser convertido para string ou uma chamada explícita para chr() deve ser feita.

### Valor Retornado

Retorna `true` se todos caracteres em `text` são letras maiúsculas na localidade atual. Quando chamada com uma string vazia, o resultado sempre será `false`.

### Exemplos

Exemplo #1 Um exemplo de ctype_upper() (usando a localidade padrão)

    <?php
    $strings = array('AKLWC139', 'LMNSDO', 'akwSKWsm');
    foreach ($strings as $testcase) {
        if (ctype_upper($testcase)) {
            echo "A string $testcase consiste inteiramente de letras maiúsculas.\n";
        } else {
            echo "A string $testcase não consiste inteiramente de letras maiúsculas.\n";
        }
    }
    ?>

O exemplo acima produzirá:

    A string AKLWC139 não consiste inteiramente de letras maiúsculas.
    A string LMNSDO consiste inteiramente de letras maiúsculas.
    A string akwSKWsm não consiste inteiramente de letras maiúsculas.

### Veja Também

- ctype_alpha() - Verifica se os caracteres são alfabéticos
- ctype_lower() - Verifica se os caracteres são minúsculos
- setlocale() - Define informação de localidade
- IntlChar::isupper() - Verifica se um ponto de código tem a categoria geral "Lu" (letra maiúscula)

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