Funzione lstrcmpA (winbase.h)

Articolo
11/20/2024

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

Per eseguire un confronto che non fa 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 a cui punta lpString1 è minore della stringa a cui punta lpString2, il valore restituito è negativo. Se la stringa a cui punta lpString1 è maggiore della stringa a cui punta lpString2, il valore restituito è positivo. Se le stringhe sono uguali, il valore restituito è zero.

Osservazioni

La funzione lstrcmp confronta due stringhe controllando i primi caratteri l'uno rispetto all'altro, i secondi caratteri l'uno contro l'altro e così via finché non trova una disuguaglianza o raggiunge le estremità delle stringhe.

Si noti che i parametri lpString1 e lpString2 devono essere terminati con null; in caso contrario, il confronto tra stringhe non può essere corretto.

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

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

Con una versione DBCS (Double Byte Character Set) del sistema, questa funzione può confrontare due stringhe DBCS.

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

osservazioni sulla sicurezza

Per considerazioni sulla sicurezza relative alla scelta delle funzioni di confronto, vedere Considerazioni sulla sicurezza: Funzionalità internazionali.

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 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 [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Kernel32.lib
dll	Kernel32.dll