toupper, _toupper, towupper, _toupper_l, _towupper_l
Converter o caractere em maiúsculas.
int toupper(
int c
);
int _toupper(
int c
);
int towupper(
wint_t c
);
int _toupper_l(
int c ,
_locale_t locale
);
int _towupper_l(
wint_t c ,
_locale_t locale
);
Parâmetros
c
Caractere a ser convertido.locale
Localidade a ser usada.
Valor de retorno
Cada uma dessas rotinas converte uma cópia de c, se possível, de e retorna o resultado.
Se c é um caractere largo para que iswlower for diferente de zero e houver um caractere largo correspondente para que iswupper for diferente de zero, towupper retorna o caractere largo correspondente; caso contrário, retornará c de towupper inalterado.
Não há nenhum valor de retorno reservado para indicar um erro.
Para que toupper dos resultados esperados, __isascii e deve islower de retorno diferente de zero.
Comentários
Cada uma dessas rotinas converte uma letra minúscula determinada a uma letra maiúscula possível e se apropriado. A conversão dos casos de towupper é específica de localidade. Somente os caracteres relevantes à localidade atual são modificados no caso de. As funções sem o sufixo de _l usam a localidade definida no momento. As versões dessas funções com o sufixo de _l levam a localidade como um parâmetro e usam o que em vez de localidade definida no momento. Para obter mais informações, consulte Localidade.
Para que toupper dos resultados esperados, __isascii e deve isupper de retorno diferente de zero.
Mapeamentos da rotina de texto genérico
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_totupper |
toupper |
_mbctoupper |
towupper |
_totupper_l |
_toupper_l |
_mbctoupper_l |
_towupper_l |
Dica
_toupper_l e _towupper_l não têm dependência de localidade e não devem ser chamados diretamente.Eles são fornecidos para uso interno por _totupper_l.
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
toupper |
<ctype.h> |
_toupper |
<ctype.h> |
towupper |
<ctype.h> ou <wchar.h> |
Para informações adicionais de compatibilidade, consulte Compatibilidade na Introdução.
Exemplo
Consulte o exemplo em funções.