Funzione CharLowerA (winuser.h)

Articolo
08/27/2023

Converte una stringa di caratteri o un singolo carattere in minuscolo. Se l'operando è una stringa di caratteri, la funzione converte i caratteri sul posto.

Sintassi

LPSTR CharLowerA(
  [in, out] LPSTR lpsz
);

Parametri

[in, out] lpsz

Tipo: LPTSTR

Stringa con terminazione Null o specifica un singolo carattere. Se la parola di ordine elevato di questo parametro è zero, la parola con ordine basso deve contenere un singolo carattere da convertire.

Valore restituito

Tipo: LPTSTR

Se l'operando è una stringa di caratteri, la funzione restituisce un puntatore alla stringa convertita. Poiché la stringa viene convertita sul posto, il valore restituito è uguale a lpsz.

Se l'operando è un singolo carattere, il valore restituito è un valore a 32 bit la cui parola di ordine elevato è zero e la parola con ordine basso contiene il carattere convertito.

Non vi è alcuna indicazione dell'esito positivo o negativo. L'errore è raro. Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.

Commenti

Si noti che CharLower esegue sempre il mapping tra lettere maiuscole e minuscole ("i"), anche quando la lingua corrente è turca o azera. Se è necessaria una funzione sensibile a livello linguistico, chiamare LCMapString.

La conversione in Unicode nella versione ANSI della funzione viene eseguita con le impostazioni locali predefinite del sistema in tutti i casi.

Nota

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

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	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll