Função CharUpperA (winuser.h)

Artigo
08/27/2023

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