_strlwr
, _wcslwr
, _mbslwr
, _strlwr_l
, _wcslwr_l
, _mbslwr_l
Mengonversi string menjadi huruf kecil. Versi yang lebih aman dari fungsi-fungsi ini tersedia; lihat _strlwr_s
, , _mbslwr_s
_strlwr_s_l
, _mbslwr_s_l
, , . _wcslwr_s_l
_wcslwr_s
Penting
_mbslwr
dan _mbslwr_l
tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.
Sintaks
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
Parameter
str
String yang dihentikan null untuk dikonversi ke huruf kecil.
locale
Lokal yang akan digunakan.
Nilai hasil
Masing-masing fungsi ini mengembalikan penunjuk ke string yang dikonversi. Karena modifikasi dilakukan di tempat, penunjuk yang dikembalikan sama dengan pointer yang diteruskan sebagai argumen input. Tidak ada nilai pengembalian yang dicadangkan untuk menunjukkan kesalahan.
Keterangan
Fungsi ini _strlwr
mengonversi huruf str
besar ke huruf kecil seperti yang ditentukan oleh LC_CTYPE
pengaturan kategori lokal. Karakter lain tidak terpengaruh. Untuk informasi selengkapnya tentang LC_CTYPE
, lihat setlocale
. Versi fungsi-fungsi ini tanpa _l
akhiran menggunakan lokal saat ini untuk perilaku dependen lokal mereka; versi dengan _l
akhiran identik kecuali bahwa mereka menggunakan lokal yang diteruskan sebagai gantinya. Untuk informasi selengkapnya, lihat Lokal.
Fungsi _wcslwr
dan _mbslwr
adalah versi karakter lebar dan multibyte-character dari _strlwr
. Argumen dan nilai yang dikembalikan adalah _wcslwr
string karakter lebar. Argumen dan nilai _mbslwr
yang dikembalikan adalah string multibyte-character. Ketiga fungsi ini berulah secara identik jika tidak.
Jika str
adalah NULL
penunjuk, handler parameter yang tidak valid dipanggil, seperti yang dijelaskan dalam Validasi parameter . Jika eksekusi diizinkan untuk melanjutkan, fungsi-fungsi ini mengembalikan string asli dan diatur errno
ke EINVAL
.
Di C++, fungsi-fungsi ini memiliki kelebihan beban templat yang memanggil rekan-rekan yang lebih baru dan aman dari fungsi-fungsi ini. Untuk informasi selengkapnya, lihat Mengamankan kelebihan beban templat.
Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.
Pemetaan rutin teks generik
TCHAR. Rutinitas H | _UNICODE dan _MBCS tidak ditentukan |
_MBCS Didefinisikan |
_UNICODE Didefinisikan |
---|---|---|---|
_tcslwr |
_strlwr |
_mbslwr |
_wcslwr |
_tcslwr_l |
_strlwr_l |
_mbslwr_l |
_wcslwr_l |
Persyaratan
Rutin | Header yang diperlukan |
---|---|
_strlwr , _strlwr_l |
<string.h> |
_wcslwr , _wcslwr_l |
<string.h> atau <wchar.h> |
_mbslwr , _mbslwr_l |
<mbstring.h> |
Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.
Contoh
// 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!
Baca juga
Manipulasi string
Lokal
_strupr
, _strupr_l
, _mbsupr
, _mbsupr_l
, _wcsupr_l
, _wcsupr
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk