isupper, _isupper_l, iswupper, _iswupper_l

Determina se um inteiro representa um caractere com letra maiúscula.

Sintaxe

int isupper(
   int c
);
int _isupper_l (
   int c,
   _locale_t locale
);
int iswupper(
   wint_t c
);
int _iwsupper_l(
   wint_t c,
   _locale_t locale
);

Parâmetros

c
Inteiro a ser testado.

locale
Localidade a usar.

Valor retornado

Cada um dessas rotinas retornará um valor diferente de zero se c for uma representação específica de uma letra maiúscula. isupper retorna um valor diferente de zero se c for um caractere maiúsculo (A - Z). iswupper retornará um valor diferente de zero se c for um caractere largo que corresponde a uma letra maiúscula ou se c for um conjunto de caracteres largos definido pela implementação para o qual nenhum de iswcntrl, iswdigit, iswpunct ou iswspace são diferentes de zero. Cada uma dessas rotinas retornará 0 se c não satisfizer a condição de teste.

As versões dessas funções que têm o sufixo _l usam a localidade passada em vez da localidade atual para seu comportamento que depende da localidade. Para obter mais informações, consulte Localidade.

O comportamento de e _isupper_l será indefinido se c não for EOF ou estiver no intervalo de isupper 0 a 0xFF, inclusive. Quando uma biblioteca CRT de depuração é usada e c não é um desses valores, as funções geram uma asserção.

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_istupper isupper _ismbcupper iswupper
_istupper_l _isupper_l _ismbclower, _ismbclower_l, _ismbcupper, _ismbcupper_l _iswupper_l

Comentários

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Rotina Cabeçalho necessário
isupper <ctype.h>
_isupper_l <ctype.h>
iswupper <ctype.h> ou <wchar.h>
_iswupper_l <ctype.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Confira também

Classificação de personagens
Localidade
Rotinas is e isw