_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr
Converte una stringa in caratteri maiuscoli. 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 utilizzati nelle applicazioni che vengono eseguite in Windows 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 scrivere in lettere minuscole.locale
Impostazioni locali da utilizzare.
Valore restituito
Restituisce un puntatore alla stringa modificata. Poiché la modifica viene eseguita sul posto, il puntatore restituito sarà lo stesso del puntatore passato come argomento di input. Nessun valore restituito è riservato per indicare un errore.
Note
La funzione _strupr converte sul posto tutte le lettere minuscole in str in maiuscole. La conversione è determinata dall'impostazione di categoria 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 _l utilizzano le impostazioni locali correnti; la versione con il suffisso _l sono identiche ad eccezione per il fatto che utilizzano le impostazioni locali passate. 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 di tipo esteso, quelli di _mbsupr sono stringhe di caratteri multibyte. Altrimenti queste tre funzioni si comportano in modo identico.
Se str è un puntatore a null, viene richiamato il gestore di parametro non valido, 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 dei modelli che richiamano le relative controparti sicure e più recenti. Per ulteriori informazioni, vedere Overload di modelli sicuri.
Mapping di routine su testo generico
Routine TCHAR.H |
_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à.
Esempio
Vedere l'esempio relativo a _strlwr.