Funzione CharUpperBuffA (winuser.h)

Articolo
08/27/2023

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

Dimensioni, 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 Set", 10) ha esito positivo, il valore restituito è 10.

Commenti

Si noti che CharUpperBuff mappa sempre I ("i") in maiuscolo I, anche quando la lingua corrente è turco o Azerbaijani. Se è necessaria una funzione sensibile in modo 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.

Esempio

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 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


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