Funzione StrCmpICA (shlwapi.h)

Confronta due stringhe usando regole di confronto C run-time (ASCII). Il confronto non fa distinzione tra maiuscole e minuscole.

Sintassi

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

Parametri

[in] pszStr1

Tipo: LPCTSTR

Puntatore alla prima stringa con terminazione Null da confrontare.

[in] pszStr2

Tipo: LPCTSTR

Puntatore alla seconda stringa con terminazione Null da confrontare.

Valore restituito

Tipo: int

Restituisce zero se le stringhe sono identiche. Restituisce un valore positivo se la stringa a cui punta lpStr1 è alfabeticamente maggiore di quella a cui punta lpStr2. Restituisce un valore negativo se la stringa a cui punta lpStr1 è alfabeticamente minore di quella a cui punta lpStr2

Osservazioni

È consigliabile usare CompareString al posto di questa funzione. StrCmpIC è stato progettato per confrontare le stringhe canoniche. Queste stringhe non sono localizzate e sono costituite solo da caratteri inferiori al valore ASCII 128. Di conseguenza, non funzionerà correttamente con dati DBCS (Double-Byte Character Set).

I caratteri maiuscoli vengono convertiti in caratteri minuscoli prima del confronto e il valore restituito si basa sul confronto dei valori convertiti. Questa funzione restituisce la differenza nel valore dei primi caratteri diversi rilevati o zero se sono tutti uguali. Ad esempio, se lpStr1="abczb" e lpStr2="abcdefg", StrCmpIC determina che "abczb" è maggiore di "abcdefg" e restituisce z - d.

Per le versioni di Windows che non includono StrCmpIC in Shlwapi.h, la singola versione ANSI o Unicode di questa funzione deve essere chiamata direttamente da Shlwapi.dll. StrCmpICA è ordinale 157 e StrCmpICW è ordinale 158.

Fabbisogno

Vedere anche

CompareString