localeconv

Mendapatkan informasi terperinci tentang pengaturan lokal.

Sintaks

struct lconv *localeconv( void );

Nilai hasil

localeconv mengembalikan penunjuk ke objek struct lconvtipe terisi . Nilai yang terkandung dalam objek disalin dari pengaturan lokal di penyimpanan lokal utas, dan dapat ditimpa oleh panggilan berikutnya ke localeconv. Perubahan yang dilakukan pada nilai dalam objek ini tidak mengubah pengaturan lokal. Memanggil ke setlocale dengan category nilai LC_ALL, , LC_MONETARYatau LC_NUMERIC menimpa konten struktur.

Keterangan

Fungsi ini localeconv mendapatkan informasi terperinci tentang pemformatan numerik untuk lokal saat ini. Informasi ini disimpan dalam struktur jenis lconv. Struktur lconv , didefinisikan dalam LOCALE. H, berisi anggota berikut:

Bidang	Makna
decimal_point, _W_decimal_point	Penunjuk ke karakter titik desimal untuk jumlah nonmonetary.
thousands_sep, _W_thousands_sep	Penunjuk ke karakter yang memisahkan grup digit ke kiri titik desimal untuk jumlah nonmonetary.
grouping	Penunjuk ke charbilangan bulat berukuran besar yang berisi ukuran setiap grup digit dalam jumlah nonmonetary.
int_curr_symbol, _W_int_curr_symbol	Penunjuk ke simbol mata uang internasional untuk lokal saat ini. Tiga karakter pertama menentukan simbol mata uang internasional alfabet seperti yang didefinisikan dalam Kode ISO 4217 untuk representasi standar Mata Uang dan Dana . Karakter keempat (karakter null sebelumnya) memisahkan simbol mata uang internasional dari kuantitas moneter.
currency_symbol, _W_currency_symbol	Penunjuk ke simbol mata uang lokal untuk lokal saat ini.
mon_decimal_point, _W_mon_decimal_point	Penunjuk ke karakter titik desimal untuk jumlah moneter.
mon_thousands_sep, _W_mon_thousands_sep	Penunjuk ke pemisah untuk grup digit ke kiri tempat desimal dalam jumlah moneter.
mon_grouping	Penunjuk ke charbilangan bulat berukuran besar yang berisi ukuran setiap grup digit dalam jumlah moneter.
positive_sign, _W_positive_sign	String menunjukkan tanda untuk jumlah moneter nonnegatif.
negative_sign, _W_negative_sign	String menunjukkan tanda untuk jumlah moneter negatif.
int_frac_digits	Jumlah digit di sebelah kanan titik desimal dalam jumlah moneter yang diformat secara internasional.
frac_digits	Jumlah digit di sebelah kanan titik desimal dalam jumlah moneter yang diformat.
p_cs_precedes	Atur ke 1 jika simbol mata uang mendahului nilai untuk kuantitas moneter berformat nonnegatif. Atur ke 0 jika simbol mengikuti nilai.
p_sep_by_space	Atur ke 1 jika simbol mata uang dipisahkan oleh spasi dari nilai untuk kuantitas moneter berformat nonnegatif. Atur ke 0 jika tidak ada pemisahan ruang.
n_cs_precedes	Atur ke 1 jika simbol mata uang mendahului nilai untuk kuantitas moneter berformat negatif. Atur ke 0 jika simbol berhasil nilai.
n_sep_by_space	Atur ke 1 jika simbol mata uang dipisahkan oleh spasi dari nilai untuk kuantitas moneter berformat negatif. Atur ke 0 jika tidak ada pemisahan ruang.
p_sign_posn	Dalam jumlah moneter berformat nonnegatif, posisi tanda positif.
n_sign_posn	Dalam jumlah moneter berformat negatif, posisi tanda positif.

Kecuali seperti yang ditentukan, anggota lconv struktur yang memiliki char * dan wchar_t * versi adalah penunjuk ke string. Setiap anggota yang sama dengan "" (atau L"" untuk wchar_t *) memiliki panjang nol, atau tidak didukung di lokal saat ini. Keduanya decimal_point dan _W_decimal_point selalu didukung dan memiliki panjang bukan nol.

Anggota char struktur adalah angka non-negatif kecil, bukan karakter. Setiap anggota yang sama dengan CHAR_MAX tidak didukung di lokal saat ini.

grouping Nilai dan mon_grouping ditafsirkan sesuai dengan aturan berikut:

• CHAR_MAX - Jangan melakukan pengelompokan lebih lanjut.

• 0 - Gunakan elemen sebelumnya untuk setiap digit yang tersisa.

• n - Jumlah digit yang membentuk grup saat ini. Elemen berikutnya diperiksa untuk menentukan ukuran grup digit berikutnya sebelum grup saat ini.

Nilai untuk int_curr_symbol ditafsirkan sesuai dengan aturan berikut:

• Tiga karakter pertama menentukan simbol mata uang internasional alfabet seperti yang didefinisikan dalam Kode ISO 4217 untuk representasi standar Mata Uang dan Dana .

• Karakter keempat (segera mendahului karakter null) memisahkan simbol mata uang internasional dari kuantitas moneter.

Nilai untuk p_cs_precedes dan n_cs_precedes ditafsirkan sesuai dengan aturan berikut ( n_cs_precedes aturan berada dalam tanda kurung):

• 0 - Simbol mata uang mengikuti nilai untuk nilai moneter berformat nonnegatif (negatif).

• 1 - Nilai awal simbol mata uang untuk nilai moneter berformat nonnegatif (negatif).

Nilai untuk p_sep_by_space dan n_sep_by_space ditafsirkan sesuai dengan aturan berikut ( n_sep_by_space aturan berada dalam tanda kurung):

• 0 - Simbol mata uang dipisahkan dari nilai menurut spasi untuk nilai moneter berformat nonnegatif (negatif).

• 1 - Tidak ada pemisahan spasi antara simbol mata uang dan nilai untuk nilai moneter berformat nonnegatif (negatif).

Nilai untuk p_sign_posn dan n_sign_posn ditafsirkan sesuai dengan aturan berikut:

• 0 - Kurung mengelilingi kuantitas dan simbol mata uang.

• 1 - Tanda tangani string yang mendahului kuantitas dan simbol mata uang.

• 2 - String tanda mengikuti kuantitas dan simbol mata uang.

• 3 - Tanda tangani string segera mendahului simbol mata uang.

• 4 - Tanda tangani string segera mengikuti simbol mata uang.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Rutin	Header yang diperlukan
localeconv	<locale.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Pustaka

Semua versi pustaka run-time C.

Lihat juga

Lokal
setlocale
strcoll Fungsi
strftime, , wcsftime_strftime_l,_wcsftime_l
strxfrm, , wcsxfrm_strxfrm_l,_wcsxfrm_l