_strlwr, _wcslwr, _mbslwr, , _strlwr_l, _wcslwr_l, _mbslwr_l

Dizeyi küçük harfe dönüştürür. Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. _strlwr_s, _strlwr_s_l, _mbslwr_s_mbslwr_s_l, , _wcslwr_s, _wcslwr_s_l.

Sözdizimi

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

Parametreler

str
Küçük harfe dönüştürmek için null ile sonlandırılan dize.

locale
Kullanılacak yerel ayar.

Dönüş değeri

Bu işlevlerin her biri dönüştürülen dizeye bir işaretçi döndürür. Değişiklik yerinde yapıldığından, döndürülen işaretçi giriş bağımsız değişkeni olarak geçirilen işaretçiyle aynıdır. Hata belirtmek için hiçbir dönüş değeri ayrılmaz.

Açıklamalar

işlevi, _strlwr str içindeki tüm büyük harfleri yerel ayarın LC_CTYPE kategori ayarı tarafından belirlenen küçük harfe dönüştürür. Diğer karakterler etkilenmez. hakkında LC_CTYPEdaha fazla bilgi için bkz setlocale. . Bu işlevlerin son eki olmayan _l sürümleri, yerel ayara bağımlı davranışları için geçerli yerel ayarı kullanır; sonekli _l sürümler, bunun yerine geçirilen yerel ayarı kullanmaları dışında aynıdır. Daha fazla bilgi için bkz . Yerel Ayar.

_wcslwr ve _mbslwr işlevleri geniş karakterli ve çok baytlı karakter sürümleridir_strlwr. bağımsız değişkeni ve dönüş değeri _wcslwr geniş karakterli dizelerdir. bağımsız değişkeni ve dönüş değeri _mbslwr çok baytlı karakter dizeleridir. Bu üç işlev aynı şekilde davranır.

bir işaretçiysestr, parametre doğrulaması bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır.NULL Yürütmenin devam etmesi için izin verilirse, bu işlevler özgün dizeyi döndürür ve olarak EINVALayarlanırerrno.

C++ dilinde, bu işlevlerin daha yeni ve güvenli karşılıklarını çağıran şablon aşırı yüklemeleri vardır. Daha fazla bilgi için bkz . Güvenli şablon aşırı yüklemeleri.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemeleri

Gereksinimler

Daha fazla uyumluluk bilgisi için bkz . Uyumluluk.

Örnek

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

Ayrıca bkz.

Dize işleme
Yerel ayar
_strupr, _strupr_l, _mbsupr, , _mbsupr_l, _wcsupr_l, _wcsupr