Funzione CharUpperA (winuser.h)

Articolo
08/27/2023

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

Sintassi

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

Parametri

[in, out] lpsz

Tipo: LPTSTR

Stringa con terminazione null o un singolo carattere. Se la parola ad ordine elevato di questo parametro è zero, la parola a basso ordine 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 di esito positivo o negativo. L'errore è raro. Non sono presenti informazioni di errore estese per questa funzione; non chiamare GetLastError.

Commenti

Si noti che CharUpper esegue sempre il mapping di 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.

Nota

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