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.

Retornar valor

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 é indefinido se c não é EOF ou 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 declaraçã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, consulte Estado global na 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 caracteres
Localidade
Rotinas is e isw