_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Článek
06/09/2015

Převede řetězec na malá písmena.Bezpečnější verze těchto funkcí jsou k dispozici; viz _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

Důležité
_mbslwr a _mbslwr_l nelze použít v aplikacích, které jsou spouštěny v modulu Windows Runtime.Další informace naleznete v tématu CRT funkce nejsou podporovány s /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

Parametry

str
Řetězec zakončený hodnotou null pro převod na malá písmena.
locale
Použité národní prostředí.

Vrácená hodnota

Každá z těchto funkcí vrací ukazatel na převedený řetězec.Vzhledem k tomu, že změna se provádí na místě, vrácený ukazatel je stejný jako ukazatel předaný jako vstupní argument.Není rezervována žádná vrácená hodnota pro indikaci chyby.

Poznámky

Funkce _strlwr převádí všechna velká písmena v str na malá písmena, jak je stanoveno nastavením kategorie LC_CTYPE národního prostředí.Jiné znaky nejsou ovlivněny.Další informace o LC_CTYPE naleznete v části setlocale.Verze těchto funkcí bez přípony _l používají aktuální národní prostředí pro toto chování závislé na národním prostředí. Verze s příponou _l jsou stejné s tím rozdílem, že používají předané národní prostředí.Další informace naleznete v tématu Národní prostředí.

Funkce _wcslwr a _mbslwr jsou širokoznaká verze a vícebajtová znaková verze _strlwr.Argument a vrácená hodnota _wcslwr jsou širokoznaké řetězce. Hodnoty _mbslwr jsou vícebajtové znakové řetězce.Tyto tři funkce se chovají identicky jinak.

Pokud je str ukazatel NULL, je vyvolána obslužná rutina neplatného parametru, jak je popsáno v Ověření parametru.Pokud provádění může pokračovat, vrátí tyto funkce původní řetězec a nastaví errno na EINVAL.

V jazyce C++ mají tyto funkce přetížení šablon, která vyvolávají novější, zabezpečené protějšky těchto funkcí.Další informace naleznete v tématu Přetížení zabezpečení šablony.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Požadavky

Rutina	Požadované záhlaví
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> nebo <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

Další informace o kompatibilitě naleznete v tématu Kompatibilita.

Příklad

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