Funzione StrCmpNA (shlwapi.h)

Articolo
11/20/2024

Confronta un numero specificato di caratteri dall'inizio di due stringhe per determinare se sono uguali. Il confronto fa distinzione tra maiuscole e minuscole. La macro StrNCmp differisce da questa funzione solo nel nome.

Sintassi

int StrCmpNA(
  [in] PCSTR psz1,
  [in] PCSTR psz2,
  [in] int   nChar
);

Parametri

[in] psz1

Tipo: PCTSTR

Puntatore alla prima stringa con terminazione Null da confrontare.

[in] psz2

Tipo: PCTSTR

Puntatore alla seconda stringa con terminazione Null da confrontare.

[in] nChar

Tipo: int

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

Valore restituito

Tipo: int

Restituisce zero se le stringhe sono identiche. Restituisce un valore positivo se il primo nChar caratteri della stringa a cui punta psz1 sono maggiori di quelli della stringa a cui punta psz2. Restituisce un valore negativo se il primo nChar caratteri della stringa a cui punta psz1 è minore di quelli della stringa a cui punta psz2.

Osservazioni

Nota

L'intestazione shlwapi.h definisce StrCmpN 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite