Função lstrcmpA (winbase.h)

Artigo
08/27/2023

Compara duas cadeias de caracteres. A comparação diferencia maiúsculas de minúsculas.

Para executar uma comparação que não diferencia maiúsculas de minúsculas, use a função lstrcmpi .

Sintaxe

int lstrcmpA(
  [in] LPCSTR lpString1,
  [in] LPCSTR lpString2
);

Parâmetros

[in] lpString1

Tipo: LPCTSTR

A primeira cadeia de caracteres terminada em nulo a ser comparada.

[in] lpString2

Tipo: LPCTSTR

A segunda cadeia de caracteres terminada em nulo a ser comparada.

Retornar valor

Tipo: int

Se a cadeia de caracteres apontada por lpString1 for menor que a cadeia de caracteres apontada por lpString2, o valor retornado será negativo. Se a cadeia de caracteres apontada por lpString1 for maior que a cadeia de caracteres apontada por lpString2, o valor retornado será positivo. Se as cadeias de caracteres forem iguais, o valor retornado será zero.

Comentários

A função lstrcmp compara duas cadeias de caracteres verificando os primeiros caracteres entre si, os segundos caracteres entre si e assim por diante até encontrar uma desigualdade ou atingir as extremidades das cadeias de caracteres.

Observe que os parâmetros lpString1 e lpString2 devem ser encerrados em nulo, caso contrário, a comparação de cadeia de caracteres pode estar incorreta.

A função chama CompareStringEx, usando a localidade do thread atual e subtrai 2 do resultado, para manter as convenções de tempo de execução C para comparar cadeias de caracteres.

O idioma (localidade do usuário) selecionado pelo usuário no momento da instalação ou por meio de Painel de Controle determina qual cadeia de caracteres é maior (ou se as cadeias de caracteres são as mesmas). Se nenhum idioma (localidade do usuário) for selecionado, o sistema executará a comparação usando valores padrão.

Com uma versão DBCS (conjunto de caracteres de byte duplo) do sistema, essa função pode comparar duas cadeias de caracteres DBCS.

A função lstrcmp usa uma classificação de palavra, em vez de uma classificação de cadeia de caracteres. Uma classificação de palavra trata hifens e apóstrofos de forma diferente do que trata outros símbolos que não são alfanuméricos, a fim de garantir que palavras como "coop" e "cooperação" permaneçam juntas dentro de uma lista classificada. Para obter uma discussão detalhada sobre classificações de palavras e classificações de cadeia de caracteres, consulte Manipulando a classificação em seus aplicativos.

Comentários de segurança

Confira Considerações de segurança: recursos internacionais para considerações de segurança sobre a escolha de funções de comparação.

Observação

O cabeçalho winbase.h define lstrcmp 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	winbase.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll