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 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 |
Confira também
Conceitual
Referência