_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l
Převeďte řetězec na malá písmena.Bezpečnější verze tyto funkce jsou k dispozici; see _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.
![]() |
---|
_mbslwra _mbslwr_l nelze použít v aplikacích, které jsou spuštěny v systému 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 převést na malá písmena.locale
Národní prostředí pro použití.
Vrácená hodnota
Každá z těchto funkcí vrací ukazatel na řetězec převedený.Protože změna se provádí na místě, ukazatel vrácena, je stejný jako ukazatel předaný jako vstupní argument.Žádné vrácená hodnota je vyhrazena udávající chybu.
Poznámky
_strlwr Funkce převede všechna velká písmena, str na malá písmena, jak je stanoven LC_CTYPE kategorie nastavení národního prostředí.Jiné znaky nejsou ovlivněny.Další informace o LC_CTYPE, viz setlocale.Verze těchto funkcí, aniž by_l příponu použít aktuální národní prostředí pro jejich chování závislé na národním prostředí; verze s _l s tím rozdílem, že používají národní prostředí, místo něho předán shodná přípona.Další informace naleznete v tématu Národní prostředí.
_wcslwr a _mbslwr jsou verze širokého znaku a vícebajtové znakové funkce _strlwr.Argument a vrací hodnotu _wcslwr jsou řetězci širokého znaku; u _mbslwr jsou vícebajtové znakové řetězce.Tyto tři funkce chovat identicky jinak.
Pokud str je NULL je vyvolán ukazatel, obslužná rutina neplatný parametr, jak je popsáno v Ověření parametrů .Je-li pokračovat, tyto funkce vrácení původní řetězec a nastavte je povoleno zpracování errno na EINVAL.
V jazyce C++ mají tyto funkce šablony přetížení, které vyvolávají novější, bezpečné protějšky těchto funkcí.Další informace naleznete v tématu Přetížení šablony zabezpečení.
Mapování rutiny obecného textu
TCHAR.Byla zahájena rutina h |
_UNICODE & _MBCS není definováno |
_MBCS, definice |
_UNICODE definována |
---|---|---|---|
_tcslwr |
_strlwr |
_mbslwr |
_wcslwr |
_tcslwr_l |
_strlwr_l |
_mbslwr_l |
_wcslwr_l |
Požadavky
Byla zahájena 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ě, viz Compatibility v úvodu.
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 );
}