toupper, _toupper, towupper, _toupper_l, _towupper_l

Articolo
06/09/2015

Convertire caratteri in maiuscolo.

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

Valore restituito

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

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

Non vi è alcun valore restituito riservato per indicare un errore.

Affinché toupper produca i risultati previsti, __isascii e islower devono entrambe restituire un valore diverso da zero.

Note

Ognuna di queste routine converte una lettera minuscola data in una lettera maiuscola se è possibile ed appropriato. La conversione da lettere maiuscole a minuscole towupper è specifica delle impostazioni locali. Solo i caratteri appropriati sulla base delle impostazioni locali correnti vengono modificati da maiuscoli a minuscoli. Le funzioni senza il suffisso _l utilizzano le impostazioni locali attualmente impostate. Le versioni di queste funzioni con il suffisso _l prendono le impostazioni locali come parametro e le utilizzano al posto delle impostazioni locali attualmente impostate. Per ulteriori informazioni, vedere Impostazioni locali.

Affinché toupper produca i risultati previsti, __isascii e isupper devono entrambe restituire un valore diverso da zero.

Routine di conversione dati

Mapping di routine di testo generico

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

Nota

_toupper_l e _towupper_l non hanno dipendenza delle impostazioni locali e non sono destinate per essere chiamate direttamente.Vengono fornite per un utilizzo interno da _totupper_l.