_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Convertit une chaîne en majuscules. Des versions plus sécurisées de ces fonctions sont disponibles. consultez la page _strupr_s, _strupr_s_l, _mbsupr_s, _mbsupr_s_l, _wcsupr_s, _wcsupr_s_l.

System_CAPS_ICON_important.jpg 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 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 en majuscules.

locale
Paramètres régionaux à utiliser.

Retourne un pointeur vers la chaîne modifiée. Étant donné que la modification est effectuée en place, le pointeur retourné est le même que le pointeur passé comme argument d’entrée. Aucune valeur de retour n'est réservée pour indiquer une erreur.

Le _strupr fonction convertit, en place, chaque lettre minuscule str en majuscules. La conversion est déterminée par la LC_CTYPE paramètre de catégorie de paramètres régionaux. Autres caractères ne sont pas affectés. Pour plus d’informations sur LC_CTYPE, consultez setlocale. Les versions de ces fonctions sans le _l suffixe d’utiliser les paramètres régionaux ; les versions avec le _l suffixe sont identiques, sauf qu’ils utilisent les paramètres régionaux passé à la place. Pour plus d’informations, consultez Locale.

_wcsupr et _mbsupr sont des versions à caractères larges et à caractères multioctets de _strupr. La valeur des arguments et de retour de _wcsupr sont des caractères larges chaînes ; 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ètre non valide 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 un ensemble errno à 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 Secure Template Overloads.

Mappages de routines de texte générique

Routine TCHAR.H_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tcsupr_strupr_mbsupr_wcsupr
_tcsupr_l_strupr_l_mbsupr_l_wcsupr_l
RoutineEn-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é, voir Compatibilité.

Consultez l’exemple de _strlwr.

System::String::ToUpper

Paramètres régionaux
Manipulation de chaînes
_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Afficher: