Lokal

Lokal mengacu pada pengaturan negara/wilayah dan bahasa yang dapat Anda gunakan untuk menyesuaikan program Anda. Beberapa kategori yang bergantung pada lokal menyertakan format tampilan untuk tanggal dan nilai moneter. Untuk informasi selengkapnya, lihat Kategori lokal.

setlocale Gunakan fungsi untuk mengubah atau mengkueri beberapa atau semua informasi lokal program atau utas saat menggunakan fungsi tanpa _l akhiran. Fungsi dengan akhiran _l akan menggunakan parameter lokal yang diteruskan untuk informasi lokal mereka selama eksekusi fungsi tertentu itu saja. Untuk membuat lokal untuk digunakan dengan fungsi dengan _l akhiran, gunakan _create_locale. Untuk membebaskan lokal ini, gunakan _free_locale. Untuk mendapatkan lokal saat ini, gunakan _get_current_locale.

Gunakan _configthreadlocale untuk mengontrol apakah setiap utas memiliki lokalnya sendiri, atau semua utas dalam program memiliki lokal yang sama. Untuk informasi selengkapnya, lihat Halaman lokal dan kode.

Versi fungsi yang lebih aman dalam tabel berikut tersedia, ditunjukkan oleh _s akhiran ("aman"). Untuk informasi selengkapnya, lihat Fitur keamanan di CRT.

Rutinitas yang bergantung pada lokal

Rutin	Menggunakan	setlocale dependensi pengaturan kategori
atof, , _atof_l_wtof,_wtof_l	Mengonversi karakter menjadi nilai floating-point	LC_NUMERIC
atoi, , _atoi_l_wtoi,_wtoi_l	Mengonversi karakter menjadi nilai bilangan bulat	LC_NUMERIC
_atoi64, , _atoi64_l_wtoi64,_wtoi64_l	Mengonversi karakter menjadi nilai bilangan bulat 64-bit	LC_NUMERIC
atol, , _atol_l_wtol,_wtol_l	Mengonversi karakter menjadi nilai panjang	LC_NUMERIC
_atodbl, , _atodbl_l_atoldbl, _atoldbl_l, , _atoflt,_atoflt_l	Mengonversi karakter menjadi nilai panjang ganda	LC_NUMERIC
is, isw rutinitas	Uji bilangan bulat yang diberikan untuk kondisi tertentu.	LC_CTYPE
isleadbyte, _isleadbyte_l	Uji byte prospek	LC_CTYPE
localeconv	Membaca nilai yang sesuai untuk memformat jumlah numerik	LC_MONETARY, LC_NUMERIC
MB_CUR_MAX	Panjang maksimum dalam byte karakter multibyte apa pun di lokal saat ini (makro ditentukan dalam STDLIB.H)	LC_CTYPE
_mbccpy, , _mbccpy_l_mbccpy_s, _mbccpy_s_l	Menyalin satu karakter multibyte	LC_CTYPE
_mbclen, , mblen_mblen_l	Memvalidasi dan mengembalikan jumlah byte dalam karakter multibyte	LC_CTYPE
strlen, , wcslen_mbslen, _mbslen_l, , _mbstrlen,_mbstrlen_l	Untuk string karakter multibyte: validasi setiap karakter dalam string; mengembalikan panjang string	LC_CTYPE
mbstowcs, , _mbstowcs_lmbstowcs_s, _mbstowcs_s_l	Mengonversi urutan karakter multibyte ke urutan karakter lebar yang sesuai	LC_CTYPE
mbtowc, _mbtowc_l	Mengonversi karakter multibyte ke karakter lebar yang sesuai	LC_CTYPE
Fungsi printf	Menulis output yang diformat	LC_NUMERIC (menentukan output karakter radiks)
Fungsi scanf	Membaca input berformat	LC_NUMERIC (menentukan pengenalan karakter radiks)
setlocale, _wsetlocale	Pilih lokal untuk program	Tidak berlaku
strcoll, , wcscoll_mbscoll, _strcoll_l, , _wcscoll_l,_mbscoll_l	Membandingkan karakter dari dua string	LC_COLLATE
_stricmp, , _wcsicmp_mbsicmp, _stricmp_l, , _wcsicmp_l,_mbsicmp_l	Membandingkan dua string tanpa memperhatikan kasus	LC_CTYPE
_stricoll, , _wcsicoll_mbsicoll, _stricoll_l, , _wcsicoll_l,_mbsicoll_l	Membandingkan karakter dari dua string (tidak peka huruf besar/kecil)	LC_COLLATE
_strncoll, , _wcsncoll_mbsncoll, _strncoll_l, , _wcsncoll_l,_mbsncoll_l	Membandingkan karakter pertama n dari dua string	LC_COLLATE
_strnicmp, , _wcsnicmp_mbsnicmp, _strnicmp_l, , _wcsnicmp_l,_mbsnicmp_l	Bandingkan karakter dari dua string tanpa memperhatikan kasus.	LC_CTYPE
_strnicoll, , _wcsnicoll_mbsnicoll, _strnicoll_l, , _wcsnicoll_l,_mbsnicoll_l	Membandingkan karakter pertama n dari dua string (tidak peka huruf besar/kecil)	LC_COLLATE
strftime, , wcsftime_strftime_l,_wcsftime_l	Format nilai tanggal dan waktu sesuai dengan argumen yang disediakan format	LC_TIME
_strlwr, , _wcslwr_mbslwr, _strlwr_l, _wcslwr_l, _mbslwr_l,_strlwr_s , _strlwr_s_l, _mbslwr_s, , _mbslwr_s_l, , _wcslwr_s_wcslwr_s_l	Konversi, di tempat, setiap huruf besar dalam string yang diberikan menjadi huruf kecil	LC_CTYPE
strtod, , _strtod_lwcstod,_wcstod_l	Mengonversi string karakter menjadi double nilai	LC_NUMERIC (menentukan pengenalan karakter radiks)
strtol, , wcstol_strtol_l,_wcstol_l	Mengonversi string karakter menjadi long nilai	LC_NUMERIC (menentukan pengenalan karakter radiks)
strtoul, , _strtoul_lwcstoul,_wcstoul_l	Mengonversi string karakter menjadi nilai panjang yang tidak ditandatangani	LC_NUMERIC (menentukan pengenalan karakter radiks)
_strupr, , _strupr_l_mbsupr, _mbsupr_l, _wcsupr_l, _wcsupr,_strupr_s , _strupr_s_l, _mbsupr_s, , _mbsupr_s_l, , _wcsupr_s_wcsupr_s_l	Konversi, di tempat, setiap huruf kecil dalam string menjadi huruf besar	LC_CTYPE
strxfrm, , wcsxfrm_strxfrm_l,_wcsxfrm_l	Mengubah string menjadi bentuk yang disatukan sesuai dengan lokal	LC_COLLATE
tolower, , _tolowertowlower, _tolower_l, _towlower_l,_mbctolower , _mbctolower_l, , _mbctoupper, _mbctoupper_l	Mengonversi karakter yang diberikan ke karakter huruf kecil yang sesuai	LC_CTYPE
toupper, , _touppertowupper, _toupper_l, _towupper_l,_mbctolower , _mbctolower_l, , _mbctoupper, _mbctoupper_l	Mengonversi karakter yang diberikan ke huruf besar yang sesuai	LC_CTYPE
wcstombs, , _wcstombs_lwcstombs_s, _wcstombs_s_l	Mengonversi urutan karakter lebar ke urutan karakter multibyte yang sesuai	LC_CTYPE
wctomb, , _wctomb_lwctomb_s, _wctomb_s_l	Mengonversi karakter lebar ke karakter multibyte yang sesuai	LC_CTYPE

Catatan

Untuk rutinitas multibyte, halaman kode multibyte harus setara dengan lokal yang diatur dengan setlocale. _setmbcp, dengan argumen _MB_CP_LOCALE membuat halaman kode multibyte sama setlocale dengan halaman kode.

Lihat juga

Internasionalisasi
Rutinitas runtime Universal C menurut kategori