_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Articolo
03/26/2013

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

Importante
_mbsupr_s e _mbsupr_s_l non possono essere utilizzati nelle applicazioni eseguite nelle finestre 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 scriver in lettere maiuscolee.
numberOfElements
Dimensione del buffer.
locale
Le impostazioni locali da utilizzare.

Valore restituito

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

Queste funzioni convalidano i parametri.Se str è un puntatore di NULL, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, le funzioni EINVAL di ritorno e errno stabilito a EINVAL.Se numberOfElements è inferiore alla lunghezza della stringa, funzioni ERANGE di ritorno e di errno stabilito a ERANGE.

Note

La conversione di funzione di _strupr_s, sul posto, ogni lettera minuscola in str in maiuscolo._wcsupr_s è la versione a caratteri estesi di _strupr_s._mbsupr_s è la versione di caratteri a più byte di _strupr_s.

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 visioni con il suffisso di _l sono identiche ma utilizzano le impostazioni locali passate in alternativa.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 Assicurarsi che gli overload del modello.

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

Mapping di routine a Testo generico