funzione lstrcmpA (winbase.h)

Articolo
03/09/2024

Confronta due stringhe di caratteri. Il confronto è distinzione tra maiuscole e minuscole.

Per eseguire un confronto che non è distinzione tra maiuscole e minuscole, usare la funzione lstrcmpi .

Sintassi

int lstrcmpA(
  [in] LPCSTR lpString1,
  [in] LPCSTR lpString2
);

Parametri

[in] lpString1

Tipo: LPCTSTR

Prima stringa con terminazione null da confrontare.

[in] lpString2

Tipo: LPCTSTR

Seconda stringa con terminazione null da confrontare.

Valore restituito

Tipo: int

Se la stringa puntata da lpString1 è minore della stringa puntata da lpString2, il valore restituito è negativo. Se la stringa puntata da lpString1 è maggiore della stringa puntata da lpString2, il valore restituito è positivo. Se le stringhe sono uguali, il valore restituito è zero.

Commenti

La funzione lstrcmp confronta due stringhe controllando i primi caratteri tra loro, i secondi caratteri tra loro e così via fino a quando non trova una disuguaglianza o raggiunge le estremità delle stringhe.

Si noti che i parametri lpString1 e lpString2 devono essere terminati con null, altrimenti il confronto tra stringhe può essere errato.

La funzione chiama CompareStringEx, usando le impostazioni locali del thread corrente e sottrae 2 dal risultato, per mantenere le convenzioni di runtime C per confrontare le stringhe.

La lingua (impostazioni locali utente) selezionata dall'utente in fase di configurazione o tramite Pannello di controllo, determina quale stringa è maggiore (o se le stringhe sono uguali). Se non viene selezionata alcuna lingua (impostazioni locali utente), il sistema esegue il confronto usando i valori predefiniti.

Con una versione del set di caratteri a byte doppio del sistema, questa funzione può confrontare due stringhe DBCS.

La funzione lstrcmp usa un ordinamento di parole anziché un ordinamento stringa. Un ordinamento di parole tratta trattini e apostrofi in modo diverso rispetto ad altri simboli che non sono alfanumerici, per garantire che le parole come "coop" e "co-op" rimangano insieme all'interno di un elenco ordinato. Per una discussione dettagliata sugli ordinamenti delle parole e delle stringhe, vedere Gestione dell'ordinamento nelle applicazioni.

Osservazioni sulla sicurezza

Vedere Considerazioni sulla sicurezza : funzionalità internazionali per considerazioni sulla sicurezza relative alla scelta delle funzioni di confronto.

Nota

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll