_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Articolo
03/26/2013

Convertire una stringa in lettere maiuscole.Più versioni sicure di queste funzioni sono disponibili, vedere _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

Importante
_mbsupr e _mbsupr_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

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 scriver in lettere maiuscolee.
locale
Le impostazioni locali da utilizzare.

Valore restituito

Restituisce un puntatore alla stringa modificata.Poiché 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.

Note

La conversione di funzione di _strupr, sul posto, ogni lettera minuscola in str in maiuscolo.La conversione è determinata dall'impostazione di categoria di LC_CTYPE delle impostazioni locali.Altri caratteri non sono interessati.Per ulteriori informazioni su LC_CTYPE, vedere setlocale.Le versioni di queste funzioni senza il suffisso di _l utilizzano le impostazioni locali correnti, le versioni con il suffisso di _l sono identiche ma utilizzano le impostazioni locali passate in alternativa.Per ulteriori informazioni, vedere Impostazioni locali.

_wcsupr e _mbsupr sono versioni a caratteri di tipo "wide" e di caratteri multibyte di _strupr.L'argomento e il valore restituito di _wcsupr sono stringhe di caratteri estesi, tali di _mbsupr sono stringhe di caratteri multibyte.Altrimenti queste tre funzioni si comportano in modo identico.

Se str è un puntatore null, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, queste funzioni restituiscono la stringa e il set originale errno a EINVAL.

In C++, queste funzioni hanno modelli di overload che invocano le più recenti, controparti sicure di queste.Per ulteriori informazioni, vedere Assicurarsi che gli overload del modello.

Mapping di routine a Testo generico

TCHAR.H routine	_UNICODE & _MBCS non definiti	_MBCS definito	_UNICODE definito
_tcsupr	_strupr	_mbsupr	_wcsupr
_tcsupr_l	_strupr_l	_mbsupr_l	_wcsupr_l

Requisiti

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

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

Vedere l'esempio relativo _strlwr.

Equivalente .NET Framework

System::String::ToUpper

Vedere anche

Riferimenti

Impostazioni locali

Modifica delle stringhe (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Condividi tramite