_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Article
06/09/2015

Convertit une chaîne en majuscules, avec les paramètres régionaux actuels ou des paramètres régionaux spécifiés qui sont passés. Ces versions _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr présentent des améliorations de sécurité, comme décrit dans Fonctionnalités de sécurité dans le CRT.

Important

_mbsupr_s et _mbsupr_s_l ne peuvent pas être utilisées dans les applications qui s'exécutent dans le Windows Runtime.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /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

Paramètres

str
Chaîne à mettre en majuscules.
numberOfElements
Taille de la mémoire tampon.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Zéro si l'opération a réussi ; code d'erreur non nul en cas d'échec.

Ces fonctions valident leurs paramètres. Si str est un pointeur NULL, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, les fonctions retournent -1 EINVAL et attribuent à errno la valeur EINVAL. Si numberOfElements est inférieur à la longueur de la chaîne de caractère, les fonctions retournent également ERANGE et attribuent à errno la valeur ERANGE.

Notes

La fonction _strupr_s convertit, sur place, toutes les lettres minuscules dans str en majuscules. _wcsupr_s est la version à caractère élargi de _strupr_s. _mbsupr_s est la version à caractères multioctet de _strupr_s.

La conversion est déterminée par le paramètre de catégorie LC_CTYPE des paramètres régionaux. Les autres caractères ne sont pas affectés. Pour plus d'informations sur LC_CTYPE, consultez setlocale. Les versions de ces fonctions sans le suffixe _l utilisent les paramètres régionaux actuels; les versions avec le suffixe _l sont identiques, sauf qu'elles utilisent à la place les paramètres régionaux passés. Pour plus d'informations, consultez Paramètres régionaux.

En C++, l'utilisation de ces fonctions est simplifiée par les surcharges de modèle ; les surcharges peuvent déduire la longueur de la mémoire tampon automatiquement (ce qui évite d'avoir à spécifier un argument taille) et peuvent remplacer automatiquement les fonctions plus anciennes et non sécurisées par leurs équivalentes plus récentes et sécurisées. Pour plus d'informations, consultez Sécuriser les surcharges de modèle.

Les versions debug de ces fonctions remplissent d'abord la mémoire tampon avec 0xFD. Pour désactiver ce comportement, utilisez _CrtSetDebugFillThreshold.

Mappages de routines de texte générique