_strlwr, , _wcslwr, _mbslwr, _strlwr_l, , _wcslwr_l_mbslwr_l

Konwertuje ciąg na małe litery. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz , , _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l._strlwr_s

Ważne

_mbslwrnie można jej _mbslwr_l używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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
Ciąg zakończony wartością null do konwersji na małe litery.

locale
Ustawienia regionalne do użycia.

Wartość zwracana

Każda z tych funkcji zwraca wskaźnik do przekonwertowanego ciągu. Ponieważ modyfikacja jest wykonywana, zwrócony wskaźnik jest taki sam jak wskaźnik przekazywany jako argument wejściowy. Żadna wartość zwracana nie jest zarezerwowana, aby wskazać błąd.

Uwagi

Funkcja _strlwr konwertuje wszystkie wielkie litery na str małe litery określone przez LC_CTYPE ustawienie kategorii ustawień regionalnych. Nie ma to wpływu na inne znaki. Aby uzyskać więcej informacji na temat LC_CTYPEprogramu , zobacz setlocale. Wersje tych funkcji bez sufiksu _l używają bieżących ustawień regionalnych do zachowania zależnego od ustawień regionalnych. Wersje z _l sufiksem są identyczne, z tą różnicą, że używają ustawień regionalnych przekazanych zamiast. Aby uzyskać więcej informacji, zobacz Ustawienia regionalne.

Funkcje _wcslwr i _mbslwr to wersje znaków wielobajtowych i wielobajtowych ._strlwr Argument i wartość zwracana _wcslwr to ciągi o szerokim znaku. Argument i wartość zwracana to ciągi wielobajtowe _mbslwr znaków. Te trzy funkcje zachowują się identycznie inaczej.

Jeśli str jest wskaźnikiem NULL , wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametru . Jeśli wykonywanie jest dozwolone do kontynuowania, te funkcje zwracają oryginalny ciąg i ustawiono wartość errno EINVAL.

W języku C++te funkcje mają przeciążenia szablonu, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji. Aby uzyskać więcej informacji, zobacz Bezpieczne przeciążenia szablonów.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS zdefiniowany	_UNICODE zdefiniowany
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Wymagania

Procedura	Wymagany nagłówek
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> lub <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

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

Zobacz też

Manipulowanie ciągami
ustawienia regionalne
_strupr, , _strupr_l, _mbsupr, _mbsupr_l, , _wcsupr_l_wcsupr