Funzione StrCmpNICA (shlwapi.h)
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 StrCmpNICA(
[in] LPCSTR pszStr1,
[in] LPCSTR 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
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) |