_strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l

Article
03/26/2013

Convertit une chaîne en majuscules, à l'aide de les paramètres régionaux ou des paramètres régionaux spécifiés passés.Ce sont des versions de _strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr avec des améliorations de sécurité comme décrit dans Fonctionnalités de sécurité du CRT.

Important

_mbsupr_s et _mbsupr_s_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.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 à profiter.
numberOfElements
Taille de la mémoire tampon.
locale
Les paramètres régionaux à utiliser.

Valeur de retour

Zéro si l'opération a réussi ; code d'erreur est différente de zéro en cas de échec.

Ces fonctions valident leurs paramètres.Si str est un pointeur d' NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres .Si est autorisé à l'exécution pour continuer, les fonctions EINVAL de retour et affectez errno à EINVAL.Si numberOfElements est inférieure à la longueur de la chaîne, des fonctions ERANGE de retour et du jeu errno à ERANGE.

Notes

La fonction d' _strupr_s convertit, en place, chaque minuscules dans str en majuscules._wcsupr_s est la version à caractère élargi d' _strupr_s._mbsupr_s est la version multioctette de caractère d' _strupr_s.

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

En C++, l'utilisation de ces fonctions est simplifié par des surcharges de modèle ; les surcharges peuvent également déduire la longueur de la mémoire tampon automatiquement (éliminant le besoin de spécifier un argument de taille) et peuvent remplacer automatiquement des fonctions plus anciennes et non sécurisées par leurs nouvelles, sécurisées équivalents.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

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

Mappages de routines de texte générique