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.