_strlwr, _wcslwr, _mbslwr, _strlwr_l, , _wcslwr_l_mbslwr_l

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

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

Parametry

str
Řetězec ukončený hodnotou null, který se má převést na malá písmena.

locale
Národní prostředí, které se má použít

Vrácená hodnota

Každá z těchto funkcí vrátí ukazatel na převedený řetězec. Vzhledem k tomu, že se změna provádí na místě, je vrácený ukazatel stejný jako ukazatel předaný jako vstupní argument. Žádná návratová hodnota není vyhrazena k označení chyby.

Poznámky

Funkce _strlwr převede všechna velká písmena na malá písmena str podle LC_CTYPE nastavení kategorie národního prostředí. Ostatní znaky nejsou ovlivněny. Další informace naleznete v LC_CTYPEtématu setlocale. Verze těchto funkcí bez přípony _l používají aktuální národní prostředí pro jejich chování závislé na národním prostředí. Verze s příponou _l jsou shodné s tím rozdílem, že místo toho používají předané národní prostředí. Další informace naleznete v tématu Národní prostředí.

_mbslwr Funkce _wcslwr jsou širokoznakové a vícebajtové verze ._strlwr Argument a návratová hodnota jsou řetězce širokého znaku _wcslwr . Argument a návratová _mbslwr hodnota jsou řetězce s vícebajtovými znaky. Tyto tři funkce se chovají stejně jinak.

Pokud str je NULL ukazatel, je vyvolána neplatná obslužná rutina 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 se 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í šablon zabezpečení.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Požadavky

Další informace o kompatibilitě najdete 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 );
}

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

Viz také

Manipulace s řetězci
Národní prostředí
_strupr, _strupr_l, _mbsupr, _mbsupr_l, , _wcsupr_l_wcsupr