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.
Nota
L'intestazione shlwapi.h definisce StrCmpC come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional, Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlwapi.h |
Libreria | Shlwapi.lib |
DLL | Shlwapi.dll (versione 5.0 o successiva) |