Funzione StrCmpCW (shlwapi.h)

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

Sintassi

int StrCmpCW(
  [out] LPCWSTR pszStr1,
  [out] LPCWSTR pszStr2
);

Parametri

[out] pszStr1

Tipo: LPCTSTR

Puntatore alla prima stringa con terminazione Null da confrontare.

[out] 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 puntata da lpStr1 è alfabeticamente maggiore di quella puntata da lpStr2. Restituisce un valore negativo se la stringa puntata da lpStr1 è alfabeticamente minore di quella puntata da lpStr2.

Commenti

È consigliabile usare la funzione CompareString al posto di questa funzione. StrCmpC è stato progettato per confrontare le stringhe canoniche. Queste stringhe non sono localizzate e sono costituite solo da caratteri inferiori al valore ASCII 128. Pertanto, non funzionerà correttamente con un set di caratteri double-byte (DBCS) o altri dati a più caratteri.

Questa funzione individua i primi caratteri non uguali e restituisce un numero positivo se il carattere della prima stringa è maggiore del carattere del secondo, un numero negativo se è minore o zero se sono uguali. Ad esempio, se lpStr1="abczb" e lpStr2="abcdefg", StrCmpC determina che il primo carattere diverso è in posizione quattro ("z" in lpStr1 e "d" in lpStr2) e restituisce un valore positivo poiché il codice ASCII per "z" è maggiore del codice ASCII per "d".

Per tali versioni di Windows che non includono StrCmpC in Shlwapi.h, è necessario chiamare direttamente dalla Shlwapi.dll la singola versione ANSI o Unicode della funzione. StrCmpCA è ordinale 155 e StrCmpCW è ordinale 156.

Requisiti

Vedi anche

CompareString