Partager via


_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 ; 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 le Windows Runtime.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 à mettre en majuscules.

  • locale
    Paramètres régionaux à utiliser.

Valeur de retour

Retourne un pointeur vers la chaîne modifiée. La modification étant effectuée en place, le pointeur retourné est identique au pointeur 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, toutes les lettres minuscules dans str en majuscules. 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 transmis. Pour plus d'informations, consultez Paramètres régionaux.

_wcsupr et _mbsupr sont des versions à caractères élargis et à caractères multi-octets de _strupr. L'argument et la valeur de retour de _wcsupr sont des chaînes à caractères larges ; ceux de _mbsupr sont des chaînes de caractères multioctets. Ces trois fonctions se comportent sinon de façon identique.

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, ces fonctions retournent la chaine originale et donnent à 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 Sécuriser les surcharges de modèle.

Mappages de routines de texte générique

Routine TCHAR.H

_UNICODE & _MBCS non définis

_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 plus d'informations sur la compatibilité, consultez Compatibilité.

Exemple

Consultez l'exemple de _strlwr.

Équivalent .NET Framework

System::String::ToUpper

Voir aussi

Référence

Paramètres régionaux

Manipulation de chaînes (CRT)

_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l