Funzione CharUpperBuffA (winuser.h)

Articolo
11/20/2024

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

Sintassi

DWORD CharUpperBuffA(
  [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 minuscoli in caratteri maiuscoli. 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 CharUpperBuff("Zenith of API Sets", 10) ha esito positivo, il valore restituito è 10.

Osservazioni

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

Esempi

Per un esempio, vedere Creazione e uso di un file temporaneo.

Nota

L'intestazione winuser.h definisce CharUpperBuff 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