Função StrCmpICA (shlwapi.h)

Artigo
11/20/2024

Compara duas cadeias de caracteres usando regras de ordenação ASCII (tempo de execução C). A comparação não diferencia maiúsculas de minúsculas.

Sintaxe

int StrCmpICA(
  [in] LPCSTR pszStr1,
  [in] LPCSTR pszStr2
);

Parâmetros

[in] pszStr1

Tipo: LPCTSTR

Um ponteiro para a primeira cadeia de caracteres terminada em nulo a ser comparada.

[in] pszStr2

Tipo: LPCTSTR

Um ponteiro para a segunda cadeia de caracteres terminada em nulo a ser comparada.

Valor de retorno

Tipo: int

Retornará zero se as cadeias de caracteres forem idênticas. Retorna um valor positivo se a cadeia de caracteres apontada por lpStr1 for alfabéticamente maior do que a apontada por lpStr2. Retorna um valor negativo se a cadeia de caracteres apontada por lpStr1 for alfabética menor do que a apontada por lpStr2

Observações

É altamente recomendável que você use CompareString no lugar dessa função. StrCmpIC foi projetado para comparar cadeias de caracteres canônicas. Essas cadeias de caracteres não são localizadas e consistem apenas em caracteres abaixo do valor ASCII 128. Portanto, ele não funcionará corretamente com dados DBCS (conjunto de caracteres de byte duplo).

Caracteres maiúsculos são convertidos em caracteres minúsculos antes da comparação e o valor retornado é baseado na comparação dos valores convertidos. Essa função retorna a diferença no valor dos primeiros caracteres desiguais encontrados ou zero se todos forem iguais. Por exemplo, se lpStr1="abczb" e lpStr2="abcdefg", StrCmpIC determinará que "abczb" é maior que "abcdefg" e retorna z - d.

Para as versões do Windows que não incluem StrCmpIC no Shlwapi.h, a versão individual do ANSI ou Unicode desta função deve ser chamada diretamente de Shlwapi.dll. StrCmpICA é ordinal 157 e StrCmpICW é ordinal 158.

Nota

O cabeçalho shlwapi.h define StrCmpIC como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do 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, Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 5.0 ou posterior)

Consulte também

CompareString

Compartilhar via