Funzione StrCmpCA (shlwapi.h)

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

Sintassi

int StrCmpCA(
  [out] LPCSTR pszStr1,
  [out] LPCSTR pszStr2
);

Parametri

[out] pszStr1

Tipo: LPCSTR

Puntatore alla prima stringa con terminazione Null da confrontare.

[out] pszStr2

Tipo: LPCSTR

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 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. Di conseguenza, non funzionerà correttamente con un set di caratteri a byte doppio (DBCS) o altri dati a più caratteri.

Questa funzione individua i primi caratteri diversi 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 non uguale è nella posizione quattro (""abcdefg", StrCmpC determina che il primo carattere diverso è nella 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 le versioni di Windows che non includono StrCmpC in Shlwapi.h, la singola versione ANSI o Unicode di questa funzione deve essere chiamata direttamente da Shlwapi.dll. StrCmpCA è ordinale 155 e StrCmpCW è ordinale 156.

Fabbisogno

Vedere anche

CompareString