_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

 

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

Convertit une chaîne en minuscules. Des versions plus sécurisées de ces fonctions sont disponibles. consultez la page _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

System_CAPS_ICON_important.jpg Important

_mbslwr et _mbslwr_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 *_strlwr(  
   char * str  
);  
wchar_t *_wcslwr(  
   wchar_t * str  
);  
unsigned char *_mbslwr(  
   unsigned char * str  
);  
char *_strlwr_l(  
   char * str,  
   _locale_t locale  
);  
wchar_t *_wcslwr_l(  
   wchar_t * str,  
   _locale_t locale  
);  
unsigned char *_mbslwr_l(  
   unsigned char * str,  
   _locale_t locale   
);  
template <size_t size>  
char *_strlwr(  
   char (&str)[size]  
); // C++ only  
template <size_t size>  
wchar_t *_wcslwr(  
   wchar_t (&str)[size]  
); // C++ only  
template <size_t size>  
unsigned char *_mbslwr(  
   unsigned char (&str)[size]  
); // C++ only  
template <size_t size>  
char *_strlwr_l(  
   char (&str)[size],  
   _locale_t locale  
); // C++ only  
template <size_t size>  
wchar_t *_wcslwr_l(  
   wchar_t (&str)[size],  
   _locale_t locale  
); // C++ only  
template <size_t size>  
unsigned char *_mbslwr_l(  
   unsigned char (&str)[size],  
   _locale_t locale   
); // C++ only  

Paramètres

str
Chaîne à convertir en minuscules.

locale
Paramètres régionaux à utiliser.

Chacune de ces fonctions retourne un pointeur vers la chaîne convertie. É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 _strlwr fonction convertit toutes les lettres majuscules dans str en minuscules comme déterminé 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 utilisent les paramètres régionaux actuels pour leur comportement dépendant des paramètres régionaux et 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.

Le _wcslwr et _mbslwr fonctions sont des versions à caractères larges et à caractères multioctets de _strlwr. La valeur des arguments et de retour de _wcslwr sont des caractères larges chaînes ; ceux de _mbslwr sont des chaînes de caractères multioctets. Ces trois fonctions se comportent sinon de façon identique.

Si str est un NULL pointeur, 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
_tcslwr_strlwr_mbslwr_wcslwr
_tcslwr_l_strlwr_l_mbslwr_l_wcslwr_l
RoutineEn-tête requis
_strlwr, _strlwr_l<string.h>
_wcslwr, _wcslwr_l<string.h> ou <wchar.h>
_mbslwr, _mbslwr_l<mbstring.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.

// crt_strlwr.c  
// compile with: /W3  
// This program uses _strlwr and _strupr to create  
// uppercase and lowercase copies of a mixed-case string.  
#include <string.h>  
#include <stdio.h>  
  
int main( void )  
{  
   char string[100] = "The String to End All Strings!";  
   char * copy1 = _strdup( string ); // make two copies  
   char * copy2 = _strdup( string );  
  
   _strlwr( copy1 ); // C4996  
   // Note: _strlwr is deprecated; consider using _strlwr_s instead  
   _strupr( copy2 ); // C4996  
   // Note: _strupr is deprecated; consider using _strupr_s instead  
  
   printf( "Mixed: %s\n", string );  
   printf( "Lower: %s\n", copy1 );  
   printf( "Upper: %s\n", copy2 );  
  
   free( copy1 );  
   free( copy2 );  
}  

Mixed: The String to End All Strings!  
Lower: the string to end all strings!  
Upper: THE STRING TO END ALL STRINGS!  

System::String::ToLower

Manipulation de chaînes
Paramètres régionaux
_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr

Afficher: