Função CharUpperA (winuser.h)
Converte uma cadeia de caracteres ou um único caractere em maiúsculas. Se o operando for uma cadeia de caracteres, a função converterá os caracteres no local.
Sintaxe
LPSTR CharUpperA(
[in, out] LPSTR lpsz
);
Parâmetros
[in, out] lpsz
Tipo: LPTSTR
Uma cadeia de caracteres terminada em nulo ou um único caractere. Se a palavra de alta ordem desse parâmetro for zero, a palavra de ordem baixa deverá conter um único caractere a ser convertido.
Valor retornado
Tipo: LPTSTR
Se o operando for uma cadeia de caracteres, a função retornará um ponteiro para a cadeia de caracteres convertida. Como a cadeia de caracteres é convertida no local, o valor retornado é igual a lpsz.
Se o operando for um único caractere, o valor retornado será um valor de 32 bits cuja palavra de alta ordem é zero e a palavra de baixa ordem contém o caractere convertido.
Não há indicação de êxito ou falha. Falha é rara. Não há informações de erro estendidas para essa função; não chame GetLastError.
Comentários
Observe que CharUpper sempre mapeia I em minúsculas ("i") para maiúsculas I, mesmo quando o idioma atual é turco ou azerbaijão. Se você precisar de uma função que seja linguisticamente sensível nesse aspecto, chame LCMapString.
A conversão em Unicode na versão ANSI da função é feita com a localidade padrão do sistema em todos os casos.
Observação
O cabeçalho winuser.h define CharUpper como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
Confira também
Conceitual
Referência