_strlwr, , _wcslwr, _strlwr_l_mbslwr, , _wcslwr_l_mbslwr_l

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

Syntaxe

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 se terminant par un caractère Null à convertir en minuscules.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Chacune de ces fonctions retourne un pointeur désignant la chaîne convertie. 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 _strlwr convertit les lettres majuscules présentes dans str en minuscules comme le détermine 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 actuels pour leur comportement dépendant des paramètres régionaux ; les versions avec le _l suffixe sont identiques, sauf qu’elles utilisent les paramètres régionaux passés à la place. Pour plus d’informations, consultez Locale.

Les fonctions _wcslwr et _mbslwr sont des versions à caractères larges et à caractères multioctets de _strlwr. L’argument et la valeur de retour sont _wcslwr des chaînes à caractères larges. L’argument et la valeur de retour sont _mbslwr des chaînes de caractères multioctets. Ces trois fonctions se comportent sinon de façon identique.

S’il str s’agit d’un NULL pointeur, le gestionnaire de paramètres non valide est appelé, comme décrit dans la validation des paramètres. 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

// 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!

Voir aussi

Manipulation de chaînes
Paramètres régionaux
_strupr, , _strupr_l, _mbsupr_l_mbsupr, , _wcsupr_l_wcsupr