_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr
Convertit une chaîne en majuscules.Les versions sécurisées de ces fonctions sont disponibles ; consultez _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.
Important
_mbsupr et _mbsupr_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.
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 à profiter.locale
Les paramètres régionaux à utiliser.
Valeur de retour
Retourne un pointeur vers une chaîne modifiée.Étant donné que la modification est effectuée en place, le pointeur retourné est le même que le pointeur est passée comme argument d'entrée.Aucune valeur de retour n'est réservée pour indiquer une erreur.
Notes
La fonction d' _strupr convertit, en place, chaque minuscules dans str en majuscules.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 versions 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.
_wcsupr et _mbsupr sont à caractères larges et des versions à caractères multioctets d' _strupr.L'argument et la valeur de retour d' _wcsupr sont des chaînes à caractères larges ; ces d' _mbsupr sont des chaînes de caractères multioctets.Ces trois fonctions se comportent de sinon.
Si str est un pointeur 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, ces fonctions retournent la chaîne et le jeu d'origine errno à EINVAL.
En C++, ces fonctions ont des surcharges de modèle qui appellent le plus récent, fixent des équivalents de ces fonctions.Pour plus d'informations, consultez Surcharges sécurisées de modèle.
Mappages de routines de texte générique
Routine de TCHAR.H |
_UNICODE et non définis _MBCS |
_MBCS défini |
_UNICODE défini |
|---|---|---|---|
_tcsupr |
_strupr |
_mbsupr |
_wcsupr |
_tcsupr_l |
_strupr_l |
_mbsupr_l |
_wcsupr_l |
Configuration requise
Routine |
En-tête requis |
|---|---|
_strupr, _strupr_l |
<string.h> |
_wcsupr, _wcsupr_l |
<string.h> ou <wchar.h> |
_mbsupr, _mbsupr_l |
<mbstring.h> |
Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.
Exemple
Consultez l'exemple pour _strlwr.