Funzione CharLowerBuffA (winuser.h)

Articolo
08/27/2023

Converte i caratteri maiuscoli in un buffer in caratteri minuscoli. La funzione converte i caratteri sul posto.

Sintassi

DWORD CharLowerBuffA(
  [in, out] LPSTR lpsz,
  [in]      DWORD cchLength
);

Parametri

[in, out] lpsz

Tipo: LPTSTR

Buffer contenente uno o più caratteri da elaborare.

[in] cchLength

Tipo: DWORD

Dimensioni, in caratteri, del buffer a cui punta lpsz. La funzione esamina ogni carattere e converte i caratteri maiuscoli in caratteri minuscoli. La funzione esamina il numero di caratteri indicati da cchLength, anche se uno o più caratteri sono caratteri Null.

Valore restituito

Tipo: DWORD

Il valore restituito è il numero di caratteri elaborati. Ad esempio, se CharLowerBuff("Acme of Operating Systems", 10) ha esito positivo, il valore restituito è 10.

Commenti

Si noti che CharLowerBuff mappa sempre io in maiuscolo I ("i"), anche quando la lingua corrente è turco o Azerbaijani. Se è necessaria una funzione sensibile in modo linguistico, chiamare LCMapSting.

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

Esempio

Per un esempio, vedere "Creazione di una finestra di dialogo ortografico" in Uso di caselle combinate.

Nota

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