_strupr, , _strupr_l, _mbsupr_l_mbsupr, , _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.

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.

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 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 Sécuriser les surcharges de modèle.

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 routines de texte générique

Spécifications

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Exemple

Consultez l’exemple pour _strlwr.

Voir aussi

Paramètres régionaux
Manipulation de chaînes
_strlwr, , _wcslwr, _strlwr_l_mbslwr, , _wcslwr_l_mbslwr_l