ToUpper, _toupper, towupper, _toupper_l, _towupper_l

Artigo
02/25/2013

Converta caracteres 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 para converter.
locale
Código de idioma.

Valor de retorno

Cada uma dessas rotinas converte uma cópia do c, se possível e retorna o resultado.

Se c é um caractere de largo para o qual iswlower é diferente de zero e um caractere largo correspondente para o qual não há iswupper é diferente de zero, towupper retorna o caractere de largo correspondente; Caso contrário, towupper retorna c inalteradas.

Nenhum valor de retorno é reservado para indicar um erro.

Para que toupper para fornecer os resultados esperados, __isascii e islower devem os dois retornam diferente de zero.

Comentários

Cada uma dessas rotinas converte determinada letra minúscula para maiúscula, se possível e apropriado.A caso, a conversão de towupper é específica da localidade.Somente os caracteres relevantes para a localidade atual são alterados no caso.As funções, sem a _l usar o sufixo atualmente definido localidade.As versões dessas funções com o _l sufixo levar a localidade como um parâmetro e use-o em vez de ser definido no momento localidade.Para obter mais informações, consulte Localidade.

Para que toupper para fornecer os resultados esperados, __isascii e isupper devem os dois retornam diferente de zero.

Rotinas de conversão de dados

Mapeamentos de rotina de texto genérico

TCHAR.Rotina H	_ Unicode & _ MBCS do arquivo não definido	_ MBCS do arquivo definido	_ Unicode definido
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Observação
_toupper_le _towupper_l não ter nenhuma dependência de localidade e não se destinam a ser chamado diretamente.Eles são fornecidos para uso interno pela _totupper_l.