Partager via


_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

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

Important

_mbslwr et _mbslwr_l ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.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 terminée par le caractère NULL à convertir en minuscules.

  • locale
    Les paramètres régionaux à utiliser.

Valeur de retour

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

Notes

La fonction d' _strlwrconvertit tous les caractères alphabétiques majuscules dans str en minuscules comme spécifié par le paramètre de catégorie d' LC_CTYPE des paramètres régionaux.D'autres caractères ne sont pas affectés.Pour plus d'informations sur LC_CTYPE, consultez l' setlocale.Les versions de ces fonctions sans suffixe d'_l utilisent les paramètres régionaux définis pour leur comportement dépendant des paramètres régionaux ; les versions avec le suffixe d' _lsont identiques sauf qu'elles utilisent les paramètres régionaux passés à la place.Pour plus d'informations, consultez Paramètres régionaux.

Les fonctions d' _wcslwr et d' _mbslwr sont à caractères larges et des versions à caractères multioctets d' _strlwr.L'argument et la valeur de retour d' _wcslwr sont des chaînes à caractères larges ; ces d' _mbslwr sont des chaînes de caractères multioctets.Ces trois fonctions se comportent de sinon.

Si str est un pointeur d' NULL, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres .Si est autorisé à l'exécution pour continuer, ces fonctions retournent la chaîne et le jeu d'origine errno à EINVAL.

En C++, ces fonctions ont des surcharges de modèle qui appellent le plus récent, fixent des équivalents de ces fonctions.Pour plus d'informations, consultez Surcharges sécurisées de modèle.

Mappages de routines de texte générique

Routine de TCHAR.H

_UNICODE et non définis _MBCS

_MBCS défini

_UNICODE défini

_tcslwr

_strlwr

_mbslwr

_wcslwr

_tcslwr_l

_strlwr_l

_mbslwr_l

_wcslwr_l

Configuration requise

Routine

En-tête requis

_strlwr, _strlwr_l

<string.h>

_wcslwr, _wcslwr_l

<string.h> ou <wchar.h>

_mbslwr, _mbslwr_l

<mbstring.h>

Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.

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 );
}
  
  
  

Équivalent .NET Framework

System::String::ToLower

Voir aussi

Référence

Manipulation de chaînes (CRT)

Paramètres régionaux

_strupr, _strupr_l, _mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr