_strupr
, _strupr_l
, _mbsupr
, _mbsupr_l
, _wcsupr_l
, _wcsupr
Convertit une chaîne en majuscules. Des versions plus sécurisées de ces fonctions sont disponibles ; voir , , _mbsupr_s
_strupr_s_l
, _mbsupr_s_l
, , _wcsupr_s
, _wcsupr_s_l
._strupr_s
Important
_mbsupr
et _mbsupr_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
char *_strupr(
char *str
);
wchar_t *_wcsupr(
wchar_t *str
);
unsigned char *_mbsupr(
unsigned char *str
);
char *_strupr_l(
char *str,
_locale_t locale
);
wchar_t *_wcsupr_l(
wchar_t *str,
_locale_t locale
);
unsigned char *_mbsupr_l(
unsigned char *str,
_locale_t locale
);
template <size_t size>
char *_strupr(
char (&str)[size]
); // C++ only
template <size_t size>
wchar_t *_wcsupr(
wchar_t (&str)[size]
); // C++ only
template <size_t size>
unsigned char *_mbsupr(
unsigned char (&str)[size]
); // C++ only
template <size_t size>
char *_strupr_l(
char (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
wchar_t *_wcsupr_l(
wchar_t (&str)[size],
_locale_t locale
); // C++ only
template <size_t size>
unsigned char *_mbsupr_l(
unsigned char (&str)[size],
_locale_t locale
); // C++ only
Paramètres
str
Chaîne à mettre en majuscules.
locale
Paramètres régionaux à utiliser.
Valeur retournée
Retourne un pointeur vers la chaîne modifiée. Sachant que la modification est effectuée sur place, le pointeur retourné est le même que celui passé comme argument d’entrée. Aucune valeur de retour n'est réservée pour indiquer une erreur.
Notes
La fonction _strupr
convertit sur place chaque lettre minuscule contenue dans str
en majuscule. 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.
_wcsupr
et _mbsupr
sont des versions à caractères larges et à caractères multioctets de _strupr
. L’argument et la valeur de retour sont _wcsupr
des chaînes à caractères larges. L’argument et la valeur de retour sont _mbsupr
des chaînes de caractères multioctets. Ces trois fonctions se comportent sinon de façon identique.
S’il str
s’agit d’un pointeur Null, le gestionnaire de paramètres non valide est appelé, comme décrit dans validation des paramètres. Si l’exécution est autorisée à se poursuivre, ces fonctions retournent la chaîne d’origine et affectent à errno
la valeur EINVAL
.
En C++, ces fonctions ont des surcharges de modèle qui appellent les équivalents plus récents et sécurisés de ces fonctions. Pour plus d’informations, consultez Surcharges de modèles sécurisés.
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 |
_strupr |
_mbsupr |
_wcsupr |
_tcsupr_l |
_strupr_l |
_mbsupr_l |
_wcsupr_l |
Spécifications
Routine | En-tête requis |
---|---|
_strupr , _strupr_l |
<string.h> |
_wcsupr , _wcsupr_l |
<string.h> ou <wchar.h> |
_mbsupr , _mbsupr_l |
<mbstring.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Exemple
Consultez l’exemple pour _strlwr
.
Voir aussi
Paramètres régionaux
Manipulation de chaîne
_strlwr
, _wcslwr
, _mbslwr
, _strlwr_l
, _wcslwr_l
, _mbslwr_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