Funzione StrIsIntlEqualA (shlwapi.h)

Articolo
11/20/2024

Confronta un numero specificato di caratteri dall'inizio di due stringhe per determinare se sono uguali.

Sintassi

BOOL StrIsIntlEqualA(
       BOOL  fCaseSens,
  [in] PCSTR pszString1,
  [in] PCSTR pszString2,
       int   nChar
);

Parametri

fCaseSens

Tipo: bool

Distinzione tra maiuscole e minuscole del confronto. Se questo valore è diverso da zero, il confronto fa distinzione tra maiuscole e minuscole. Se questo valore è zero, il confronto non fa distinzione tra maiuscole e minuscole.

[in] pszString1

Tipo: PCTSTR

Puntatore alla prima stringa con terminazione Null da confrontare.

[in] pszString2

Tipo: PCTSTR

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: bool

TRUE se i primi caratteri nChar delle due stringhe sono uguali; in caso contrario, FALSE.

Osservazioni

È possibile impostare la distinzione tra maiuscole e minuscole con le macro StrIntlEqN e StrIntlEqNI. StrIntlEqN esegue un confronto con distinzione tra maiuscole e minuscole e StrIntlEqNI esegue un confronto senza distinzione tra maiuscole e minuscole.

La sintassi delle due macro è:

#define StrIntlEqN(s1, s2, nChar) StrIsIntlEqual(TRUE, s1, s2, nChar)
#define StrIntlEqNI(s1, s2, nChar) StrIsIntlEqual(FALSE, s1, s2, nChar)

Nota

L'intestazione shlwapi.h definisce StrIsIntlEqual 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