Função CharLowerBuffA (winuser.h)

Artigo
03/13/2024

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

Sintaxe

DWORD CharLowerBuffA(
  [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 maiúsculos em caracteres minúsculos. A função examina o número de caracteres indicados por cchLength, mesmo que um ou mais caracteres sejam caracteres nulos.

Retornar valor

Tipo: DWORD

O valor retornado é o número de caracteres processados. Por exemplo, se CharLowerBuff("Acme of Operating Systems", 10) for bem-sucedido, o valor retornado será 10.

Comentários

Observe que CharLowerBuff sempre mapeia maiúsculas I para letras minúsculas I ("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 LCMapSting.

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 uma caixa de diálogo ortográfica" em Usando caixas de combinação.

Observação

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

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