Funzione StrCmpNICW (shlwapi.h)

Articolo
08/26/2023

Confronta un numero specificato di caratteri dall'inizio di due stringhe usando regole di confronto C run-time (ASCII). Nel confronto non viene fatta distinzione tra maiuscole e minuscole.

Sintassi

int StrCmpNICW(
  [in] LPCWSTR pszStr1,
  [in] LPCWSTR pszStr2,
       int     nChar
);

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.

nChar

Tipo: int

Numero di caratteri dall'inizio di ogni stringa da confrontare.

Valore restituito

Tipo: int

Restituisce zero se le sottostringhe sono identiche. Restituisce un valore positivo se la stringa ricavata da quella a cui punta pszStr1 è alfabeticamente maggiore della stringa ricavata da quella a cui punta pszStr2. Restituisce un valore negativo se la stringa ricavata da quella a cui punta pszStr1 è alfabeticamente minore della stringa ricavata da quella a cui punta pszStr2.

Commenti

Si noti che StrCmpNIC è 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 a byte doppio (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. Si supponga, ad esempio, che pszStr1="abczb", pszStr2="abcdefg" e si confrontino i primi quattro caratteri di ognuno. StrCmpNIC determina che il primo carattere diverso è nella posizione quattro ("z" in pszStr1 e "d" in pszStr2) e restituisce un valore positivo perché il codice ASCII per "z" è maggiore del codice ASCII per "d".

Per le versioni di Windows che non includono StrCmpNIC in Shlwapi.h, la singola versione ANSI o Unicode di questa funzione deve essere chiamata direttamente da Shlwapi.dll. StrCmpNICA è ordinale 153 e StrCmpNICW è ordinale 154.

Nota

L'intestazione shlwapi.h definisce StrCmpNIC come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti


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)

Vedi anche

CompareString

StrCmpIC

StrCmpNI

Condividi tramite