Função CharUpperA (winuser.h)
Converte uma cadeia de caracteres ou um único caractere em letras 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 de retorno
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 em vigor, 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 ordem baixa contém o caractere convertido.
Não há nenhuma indicação de êxito ou falha. Falha é rara. Não há informações de erro estendidas para essa função; não chame GetLastError.
Observações
Observe que charupper sempre mapeia letras minúsculas I ("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.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | winuser.h (inclua Windows.h) |
| biblioteca | User32.lib |
| de DLL |
User32.dll |
Consulte também
Conceitual
de referência de