Função StrCmpLogicalW (shlwapi.h)

  • Artigo

Compara duas cadeias de caracteres Unicode. Os dígitos nas cadeias de caracteres são considerados como conteúdo numérico em vez de texto. Este teste não diferencia maiúsculas de minúsculas.

Sintaxe

int StrCmpLogicalW(
  [in] PCWSTR psz1,
  [in] PCWSTR psz2
);

Parâmetros

[in] psz1

Tipo: PCWSTR

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

[in] psz2

Tipo: PCWSTR

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

Retornar valor

Tipo: int

  • Retornará zero se as cadeias de caracteres forem idênticas.
  • Retornará 1 se a cadeia de caracteres apontada por psz1 tiver um valor maior do que o apontado por psz2.
  • Retornará -1 se a cadeia de caracteres apontada por psz1 tiver um valor menor do que o apontado por psz2.

Comentários

O esquema de ordenação dessa função difere um pouco do StrCmpI, que também compara cadeias de caracteres sem considerar a confidencialidade de maiúsculas e minúsculas. Considerando dígitos pelo valor numérico, como strCmpLogicalW faz, as cadeias de caracteres são ordenadas da seguinte maneira:

2string
3string
20string
st2ring
st3ring
st20ring
string2
string3
string20

StrCmpI considera dígitos na cadeia de caracteres apenas como texto para que essas mesmas cadeias de caracteres sejam ordenadas da seguinte maneira:

20string
2string
3string
st20ring
st2ring
st3ring
string2
string20
string3
Nota O comportamento dessa função e, portanto, os resultados retornados por ela, podem mudar de versão para versão. Ele não deve ser usado para aplicativos de classificação canônica.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
Biblioteca Shlwapi.lib
DLL Shlwapi.dll (versão 5.5 ou posterior)