Funzione CharUpperA (winuser.h)

Articolo
11/20/2024

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 dell'ordine elevato di questo parametro è zero, la parola con ordine minimo 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.

Osservazioni

Si noti che CharUpper mappa sempre i minuscoli ("i") a I maiuscoli, anche quando la lingua corrente è turco o azero. 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.

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