Funzione StrCmpNCA (shlwapi.h)

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

Sintassi

int StrCmpNCA(
  [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.

Osservazioni

Si noti che StrCmpNC è 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. Si supponga, ad esempio, che pszStr1="abczb", pszStr2="abcdefg" e si confrontano i primi quattro caratteri da ognuno. StrCmpNC determina che il primo carattere diverso si trova nella posizione quattro ("z" in pszStr1 e "d" in pszStr2) 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 StrCmpNC in Shlwapi.h, la singola versione ANSI o Unicode di questa funzione deve essere chiamata direttamente da Shlwapi.dll. StrCmpNCA è ordinale 151 e strCmpNCW è ordinale 152.

Fabbisogno

Vedere anche

CompareString

StrCmpC

StrCmpN