_strupr_s
, _strupr_s_l
, _mbsupr_s
, _mbsupr_s_l
, _wcsupr_s
, _wcsupr_s_l
Convertit une chaîne en majuscules en utilisant les paramètres régionaux actifs ou des paramètres régionaux spécifiés qui ont été transmis. Ces versions de _strupr
, _strupr_l
_mbsupr
_mbsupr_l
, , _wcsupr_l
, ont _wcsupr
des améliorations de sécurité, comme décrit dans les 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 Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge dans les applications de la plateforme Windows universelle.
Syntaxe
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 retournée
Zéro en cas de réussite ; code d’erreur différent de zéro en cas d’échec.
Ces fonctions valident leurs paramètres. S’il str
s’agit d’un NULL
pointeur, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. Si l’exécution est autorisée à se poursuivre, les fonctions retournent EINVAL
et affectent à errno
la valeur EINVAL
. Si la valeur de numberOfElements
est inférieure à la longueur de la chaîne, ces fonctions retournent ERANGE
et affectent à errno
la valeur ERANGE
.
Notes
La fonction _strupr_s
convertit sur place chaque lettre minuscule contenue dans str
en majuscule. _wcsupr_s
est la version à caractères larges de _strupr_s
. _mbsupr_s
est la version à caractères multioctets 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 suffixe _l
utilisent les paramètres régionaux actifs ; les versions avec suffixe _l
sont identiques, sauf qu’elles utilisent à la place les paramètres régionaux transmis. Pour plus d’informations, consultez Locale.
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 Surcharges de modèles sécurisés.
Les versions de bibliothèque de débogage de ces fonctions remplissent d’abord la mémoire tampon avec 0xFE. Pour désactiver ce comportement, utilisez _CrtSetDebugFillThreshold
.
Par défaut, l’état global de cette fonction est limité à l’application. Pour modifier ce comportement, consultez État global dans le CRT.
Mappages de routine de texte générique
Routine TCHAR.H | _UNICODE et _MBCS non défini |
_MBCS Défini |
_UNICODE Défini |
---|---|---|---|
_tcsupr_s |
_strupr_s |
_mbsupr_s |
_wcsupr_s |
_tcsupr_s_l |
_strupr_s_l |
_mbsupr_s_l |
_wcsupr_s_l |
Spécifications
Routine | En-tête requis |
---|---|
_strupr_s , _strupr_s_l |
<string.h> |
_wcsupr_s , _wcsupr_s_l , _mbsupr_s , _mbsupr_s_l |
<string.h> ou <wchar.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Exemple
Consultez l’exemple pour , , _mbslwr_s_l
_mbslwr_s
_strlwr_s_l
, _wcslwr_s
, _wcslwr_s_l
._strlwr_s
Voir aussi
Paramètres régionaux
Interprétation des séquences de caractères multioctets
Manipulation de chaîne
_strlwr_s
, _strlwr_s_l
, _mbslwr_s
, _mbslwr_s_l
, _wcslwr_s
, _wcslwr_s_l
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour