Funzione CharLowerBuffA (winuser.h)

Articolo
11/20/2024

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

Dimensione, 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.

Osservazioni

Si noti che CharLowerBuff mappa sempre i maiuscoli a I minuscoli ("i"), anche quando la lingua corrente è turco o azero. Se è necessaria una funzione sensibile dal punto di vista 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.

Esempi

Per un esempio, vedere "Creazione di una finestra di dialogo ortografia" 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 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	winuser.h (include Windows.h)
libreria	User32.lib
dll	User32.dll