Compartilhar via


Função CharLowerA (winuser.h)

Converte uma cadeia de caracteres ou um único caractere em letras minúsculas. Se o operando for uma cadeia de caracteres, a função converterá os caracteres no local.

Sintaxe

LPSTR CharLowerA(
  [in, out] LPSTR lpsz
);

Parâmetros

[in, out] lpsz

Tipo: LPTSTR

Uma cadeia de caracteres terminada em nulo ou especifica um único caractere. Se a palavra de alta ordem desse parâmetro for zero, a palavra de ordem baixa deverá conter um único caractere a ser convertido.

Retornar valor

Tipo: LPTSTR

Se o operando for uma cadeia de caracteres, a função retornará um ponteiro para a cadeia de caracteres convertida. Como a cadeia de caracteres é convertida no local, o valor retornado é igual a lpsz.

Se o operando for um único caractere, o valor retornado será um valor de 32 bits cuja palavra de alta ordem é zero e a palavra de baixa ordem contém o caractere convertido.

Não há indicação de êxito ou falha. Falha é rara. Não há informações de erro estendidas para essa função; não chame GetLastError.

Comentários

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

Observação

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

CharLowerBuff

CharUpper

CharUpperBuff

Conceitual

Referência

Cadeias de caracteres