Compartilhar via


Função CharLowerBuffA (winuser.h)

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 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 CharLowerBuff("Acme of Operating Systems", 10) for bem-sucedido, o valor retornado será 10.

Observações

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.

Nota

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

charupper

CharUpperBuff

Conceitual

de referência de

cadeias de caracteres