toupper, _toupper, towupper, _toupper_l_towupper_l

Converte un carattere in maiuscolo.

Sintassi

int toupper(
   int c
);
int _toupper(
   int c
);
int towupper(
   wint_t c
);
int _toupper_l(
   int c ,
   _locale_t locale
);
int _towupper_l(
   wint_t c ,
   _locale_t locale
);

Parametri

c
Carattere da convertire.

locale
Impostazioni locali da usare.

Valore restituito

Ognuna di queste routine converte una copia di c, se possibile, e restituisce il risultato.

Se c è un carattere wide per il quale iswlower è diverso da zero e esiste un carattere wide corrispondente per il quale iswupper è diverso da zero, towupper restituisce il carattere wide corrispondente; in caso contrario, towupper restituisce c invariato.

Non esiste alcun valore restituito riservato per indicare un errore.

Osservazioni:

Ognuna di queste routine converte una determinata lettera minuscola in maiuscola, se possibile e appropriato. La conversione della combinazione di maiuscole/minuscole di towupper dipende dalle impostazioni locali. La combinazione di maiuscole/minuscole viene modificata solo per i caratteri rilevanti per le impostazioni locali correnti. Le funzioni senza il suffisso _l usano le impostazioni locali correnti. Le versioni di queste funzioni con il suffisso _l accettano le impostazioni locali come parametro e usano tali impostazioni invece di quelle correnti. Per altre informazioni, vedere Locale.

Per toupper fornire i risultati previsti, __isascii deve restituire un valore diverso da zero.

Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.

Mapping di routine di testo generico

TCHAR.H Routine	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_totupper	toupper	_mbctoupper	towupper
_totupper_l	_toupper_l	_mbctoupper_l	_towupper_l

Nota

Le funzioni _toupper_l e _towupper_l non dipendono dalle impostazioni locali e non sono progettate per essere chiamate direttamente. Sono destinate solo all'uso interno per _totupper_l.

Requisiti

Ciclo	Intestazione obbligatoria
toupper	<ctype.h>
_toupper	<ctype.h>
towupper	<ctype.h> o <wchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

Vedere l'esempio nelle to funzioni.

Vedi anche

is, isw routine
Funzioni to
impostazioni locali
Interpretazione di sequenze di caratteri multibyte