Função CharUpperBuffA (winuser.h)

Artigo
11/20/2024

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 indicado por cchLength, mesmo que um ou mais caracteres sejam caracteres nulos.

Valor de retorno

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.

Observações

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.

Nota

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 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

charLower

CharLowerBuff

charupper

Conceitual

de referência de

cadeias de caracteres

Compartilhar via