toupper, _toupper, towupper, _toupper_l, _towupper_l

Converta caractere em maiúscula.

Sintaxe

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 usar.

Valor retornado

Todas essas rotinas convertem uma cópia do c, se possível e retornam o resultado.

Se c for um caractere largo para o qual iswlower não é zero e houver um caractere largo correspondente para o qual iswupper não é zero, towupper retornará o caractere largo correspondente; caso contrário, towupper retornará c inalterado.

Não há nenhum valor retornado reservado para indicar um erro.

Comentários

Cada uma dessas rotinas converte determinada letra minúscula em maiúscula, se for possível e relevante. A conversão de maiúsculas e minúsculas de towupper é específica da localidade. Somente caracteres relevantes à localidade atual são alterados quanto a maiúsculas e minúsculas. As funções sem o sufixo _l usam a localidade definida atualmente. As versões dessas funções com o sufixo _l usam a localidade como parâmetro e a usam em vez da localidade definida atualmente. Para obter mais informações, consulte Localidade.

Para toupper fornecer os resultados esperados, __isascii deve retornar diferente de zero.

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

Mapeamentos de rotina de texto genérico

Rotina TCHAR.H	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Observação

_toupper_l e _towupper_l não têm dependência de localidade e não se destinam a serem 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 obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Veja o exemplo em funções to.

Confira também

Rotinas is e isw
Funções to
Localidade
Interpretação de sequências de caracteres multibyte