Função CharUpperBuffA (winuser.h)

Artigo
08/27/2023

Converte caracteres minúsculos em um buffer em caracteres maiúsculos. A função converte os caracteres no local.

Sintaxe

DWORD CharUpperBuffA(
  [in, out] LPSTR lpsz,
  [in]      DWORD cchLength
);

Parâmetros

[in, out] lpsz

Tipo: LPTSTR

Um buffer que contém um ou mais caracteres a serem processados.

[in] cchLength

Tipo: DWORD

O tamanho, em caracteres, do buffer apontado por lpsz.

A função examina cada caractere e converte caracteres minúsculos em caracteres maiúsculos. A função examina o número de caracteres indicados por cchLength, mesmo que um ou mais caracteres sejam caracteres nulos.

Valor retornado

Tipo: DWORD

O valor retornado é o número de caracteres processados.

Por exemplo, se CharUpperBuff("Zenith of API Sets", 10) for bem-sucedido, o valor retornado será 10.

Comentários

Observe que CharUpperBuff 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.

Exemplos

Para obter um exemplo, consulte Criando e usando um arquivo temporário.

Observação

O cabeçalho winuser.h define CharUpperBuff 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