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.