_strlwr, _wcslwr, _mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l

Makale
03/27/2013

Bir dizeyi küçük harfe dönüştürür.Bu işlevlerin daha güvenli sürümlerinde kullanılabilir; see _strlwr_s, _strlwr_s_l, _mbslwr_s, _mbslwr_s_l, _wcslwr_s, _wcslwr_s_l.

Önemli
_mbslwrve _mbslwr_l Windows çalışma zamanı yürütme uygulamalarda kullanılamaz.Daha fazla bilgi için bkz: /zw ile desteklenmeyen crt işlevlerinin.

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 sonlandırılmış bir dize.
locale
Kullanılacak yerel ayarı.

Dönüş Değeri

Bu işlevlerden her biri için dönüştürülmüş dize bir işaretçi döndürür.Bir yerde değişiklik yapıldığından, işaretçiyi aynı giriş bağımsız değişken olarak geçirilen işaretçi döndürdü.Hiçbir değer döndürmeyen bir hatayı göstermek için ayrılmıştır.

Notlar

_strlwr İşlev dönüştürür herhangi bir büyük harf str tarafından belirlenen küçük LC_CTYPE bölgesel ayar kategori.Diğer karakterler etkilenmez.Daha fazla bilgi için LC_CTYPE, bkz: setlocale.Bu işlevler sürümlerini_l soneki kullanan geçerli yerel ayarı, yerel ayarlara bağımlı davranışlarını; sürümleri ile _l sonek dışında bunun yerine geçirilen yerel kullandıkları aynı.Daha fazla bilgi için bkz. Yerel ayar.

_wcslwr Ve _mbslwr işlevlerdir geniş karakter ve çok baytlı karakter sürümleri _strlwr.Yazmaç değeri _wcslwr geniş karakter dizesidir; _mbslwr çok baytlı karakter dizeleridir.Bu üç işlevi aynı şekilde aksi davranır.

str Olan bir NULL işaretçisi geçersiz parametre işleyici çağrıldığında, açıklandığı gibi Parametre doğrulama .Devam etmek için bu özgün dize işlevlerinin dönüş ve set yürütülmesine izin verilip verilmediğini errno için EINVAL.

Bu işlevleri C++'da, bu işlevlerin daha yeni ve güvenli karşılıkları çağırmak şablon aşırı yükleme vardır.Daha fazla bilgi için bkz. Güvenli şablon aşırı yükleme.

Genel metin eşlemeleri yordamına girildi

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlanmamış	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tcslwr	_strlwr	_mbslwr	_wcslwr
_tcslwr_l	_strlwr_l	_mbslwr_l	_wcslwr_l

Gereksinimler

Yordamı	Gerekli başlık
_strlwr, _strlwr_l	<string.h>
_wcslwr, _wcslwr_l	<string.h> veya <wchar.h>
_mbslwr, _mbslwr_l	<mbstring.h>

Ek uyumluluk bilgileri için bkz: Uyumluluk giriş.

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