_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Articolo
06/09/2015

Converte una stringa in lettere maiuscole, utilizzando le impostazioni locali correnti o delle impostazioni locali specificate. Queste versioni di _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr contengono i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

Importante

_mbsupr_s e _mbsupr_s_l non possono essere utilizzate nelle applicazioni che vengono eseguite in Windows Runtime.Per ulteriori informazioni, vedere Funzioni CRT non supportate con /ZW.

errno_t _strupr_s(
   char *str,
   size_t numberOfElements
);
errno_t _wcsupr_s(
   wchar_t * str,
   size_t numberOfElements
);
errno_t _strupr_s_l(
   char * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _wcsupr_s_l(
   wchar_t * str,
   size_t numberOfElements,
   _locale_t locale
);
errno_t _mbsupr_s(
   unsigned char *str,
   size_t numberOfElements
);
errno_t _mbsupr_s_l(
   unsigned char *str,
   size_t numberOfElements,
   _locale_t locale
);
template <size_t size>
errno_t _strupr_s(
   char (&str)[size]
); // C++ only
template <size_t size>
errno_t _wcsupr_s(
   wchar_t (&str)[size]
); // C++ only
template <size_t size>
errno_t _strupr_s_l(
   char (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _wcsupr_s_l(
   wchar_t (&str)[size],
   _locale_t locale
); // C++ only
template <size_t size>
errno_t _mbsupr_s(
   unsigned char (&str)[size]
); // C++ only
template <size_t size>
errno_t _mbsupr_s_l(
   unsigned char (&str)[size],
   _locale_t locale
); // C++ only

Parametri

str
Stringa da scrivere in lettere minuscole.
numberOfElements
Dimensione del buffer.
locale
Impostazioni locali da utilizzare.

Valore restituito

Zero se ha esito positivo; un codice diverso da zero in caso di errore.

Queste funzioni convalidano i parametri. Se str è un puntatore NULL, viene richiamato il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione restituisce EINVAL e imposta errno su EINVAL. Se numberOfElements è inferiore alla lunghezza della stringa, le funzioni restituiscono ERANGE e impostano errno su ERANGE.

Note

La funzione _strupr_s converte sul posto tutte le lettere minuscole in str in maiuscole. _wcsupr_s è la versione a caratteri di tipo "wide" di _strupr_s. _mbsupr_s è la versione a caratteri multibyte di _strupr_s.

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; le viste con il suffisso _l sono identiche ad eccezione del fatto che utilizzano le impostazioni locali passate. Per ulteriori informazioni, vedere Impostazioni locali.

In C++, l'utilizzo di queste funzioni è semplificato dagli overload dei modelli; gli overload possono dedurre la lunghezza del buffer automaticamente (che elimina la necessità di specificare un argomento di dimensione) e possono sostituire automaticamente le funzioni precedenti, quelle non sicure alle più recenti e le controparti sicure. Per ulteriori informazioni, vedere Overload di modelli sicuri.

La versione di debug di queste funzioni per prima cosa riempiono il buffer con il valore 0xFD. Per disattivare questo comportamento, utilizzare _CrtSetDebugFillThreshold.

Mapping di routine su testo generico