_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Converte una stringa in lettere maiuscole. Sono disponibili versioni più sicure di queste funzioni; vedere _strupr_s, _strupr_s_l, _mbsupr_s_mbsupr_s_l, , _wcsupr_s, . _wcsupr_s_l

Importante

_mbsupr e _mbsupr_l non possono essere usati nelle applicazioni eseguite in Windows Runtime. Per altre informazioni, vedere Funzioni CRT non supportate nelle app della piattaforma UWP (Universal Windows Platform).

Sintassi

char *_strupr(
   char *str
);
wchar_t *_wcsupr(
   wchar_t *str
);
unsigned char *_mbsupr(
   unsigned char *str
);
char *_strupr_l(
   char *str,
   _locale_t locale
);
wchar_t *_wcsupr_l(
   wchar_t *str,
   _locale_t locale
);
unsigned char *_mbsupr_l(
   unsigned char *str,
   _locale_t locale
);
template <size_t size>
char *_strupr(
   char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

Parametri

str
Stringa da convertire in lettere maiuscole.

locale
Impostazioni locali da usare.

Valore restituito

Restituisce un puntatore alla stringa modificata. Dato che la modifica viene eseguita sul posto, il puntatore restituito è uguale al puntatore passato come argomento di input. Nessun valore restituito è riservato per indicare un errore.

Osservazioni:

La funzione _strupr converte sul posto ogni lettera minuscola in str in maiuscolo. La conversione dipende dall'impostazione della categoria LC_CTYPE delle impostazioni locali. Gli altri caratteri non sono interessati. Per altre informazioni su LC_CTYPE, vedere setlocale. Le versioni di queste funzioni senza il suffisso _l usano le impostazioni locali correnti. Le versioni con il suffisso _l sono identiche ma usano le impostazioni locali passate. Per altre informazioni, vedere Locale.

_wcsupr e _mbsupr sono versioni con caratteri wide e caratteri multibyte di _strupr. L'argomento e il valore restituito di sono stringhe di _wcsupr caratteri wide. L'argomento e il valore restituito di sono stringhe di _mbsupr caratteri multibyte. A parte ciò, queste tre funzioni si comportano in modo identico.

Se str è un puntatore Null, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri . Se l'esecuzione può continuare, queste funzioni restituiscono la stringa originale e impostano errno su EINVAL.

In C++ queste funzioni presentano overload di modello che richiamano le relative controparti più recenti e sicure. Per altre informazioni, vedere Proteggere gli overload dei modelli.

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

Routine TCHAR.H	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Requisiti

Ciclo	Intestazione obbligatoria
_strupr, _strupr_l	<string.h>
_wcsupr, _wcsupr_l	<string.h> o <wchar.h>
_mbsupr, _mbsupr_l	<mbstring.h>

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

Esempio

Vedere l'esempio per _strlwr.

Vedi anche

impostazioni locali
Manipolazione delle stringhe
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l