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, _strlwr_l_mbslwr, _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_l_mbsupr, _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