ToUpper, _toupper, towupper, _toupper_l, _towupper_l

Artigo
08/25/2010

Converta 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 para converter.
locale
Localidade usar.

Valor de retorno

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

If c é um caractere de largo para o qual iswlower é diferente de zero e houver um caractere largo correspondente para o qual iswupper é diferente de zero, towupper Retorna o correspondente caractere largo; caso contrário, towupper Retorna c inalterado.

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

Para que toupper para fornecer os resultados esperados, __isascii and islower deve retornar todas diferente de zero.

Comentários

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

Para que toupper para fornecer os resultados esperados, __isascii and isupper deve retornar todas diferente de zero.

Rotinas de conversão de dados

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_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 ter nenhuma dependência de localidade e não pretendem ser chamado diretamente. Eles são fornecidos para uso interno por _totupper_l.