Fungsi GetNumberFormatEx (winnls.h)

Artikel
03/08/2023

Memformat string angka sebagai string angka yang dikustomisasi untuk lokal yang ditentukan oleh nama.

Catatan Aplikasi harus memanggil fungsi ini disukai getNumberFormat jika dirancang untuk berjalan hanya di Windows Vista dan yang lebih baru.

Catatan Fungsi ini dapat memformat data yang berubah antar rilis, misalnya, karena lokal kustom. Jika aplikasi Anda harus mempertahankan atau mengirimkan data, lihat Menggunakan Data Lokal Persisten.

Sintaks

int GetNumberFormatEx(
  [in, optional]  LPCWSTR          lpLocaleName,
  [in]            DWORD            dwFlags,
  [in]            LPCWSTR          lpValue,
  [in, optional]  const NUMBERFMTW *lpFormat,
  [out, optional] LPWSTR           lpNumberStr,
  [in]            int              cchNumber
);

Parameter

[in, optional] lpLocaleName

Arahkan ke nama lokal, atau salah satu nilai yang telah ditentukan sebelumnya berikut ini.

[in] dwFlags

Bendera yang mengontrol operasi fungsi. Aplikasi harus mengatur parameter ini ke 0 jika lpFormat tidak diatur ke NULL. Dalam hal ini, fungsi memformat string menggunakan penimpaan pengguna ke format nomor default untuk lokal. Jika lpFormat diatur ke NULL, aplikasi dapat menentukan LOCALE_NOUSEROVERRIDE untuk memformat string menggunakan format nomor default sistem untuk lokal yang ditentukan.

Hati Penggunaan LOCALE_NOUSEROVERRIDE sangat tidak disarankan karena menonaktifkan preferensi pengguna.

[in] lpValue

Penunjuk ke string yang dihentikan null yang berisi string angka yang akan diformat. String ini hanya dapat berisi karakter berikut. Semua karakter lainnya tidak valid. Fungsi mengembalikan kesalahan jika string yang ditunjukkan oleh lpValue menyimpang dari aturan ini.

Karakter "0" hingga "9".
Satu titik desimal (titik) jika angkanya adalah nilai floating-point.
Tanda minus di posisi karakter pertama jika angka tersebut adalah nilai negatif.

[in, optional] lpFormat

Penunjuk ke struktur NUMBERFMT yang berisi informasi pemformatan angka, dengan semua anggota diatur ke nilai yang sesuai. Jika aplikasi tidak mengatur parameter ini ke NULL, fungsi menggunakan lokal hanya untuk informasi pemformatan yang tidak ditentukan dalam struktur, misalnya, nilai string lokal untuk tanda negatif.

[out, optional] lpNumberStr

Penunjuk ke buffer tempat fungsi ini mengambil string angka yang diformat. Atau, parameter ini berisi NULL jika cchNumber diatur ke 0. Dalam hal ini, fungsi mengembalikan ukuran yang diperlukan untuk buffer string angka.

[in] cchNumber

Ukuran, dalam karakter, untuk buffer string angka yang ditunjukkan oleh lpNumberStr. Atau, aplikasi dapat mengatur parameter ini ke 0. Dalam hal ini, fungsi mengembalikan ukuran yang diperlukan untuk buffer string angka dan tidak menggunakan parameter lpNumberStr .

Nilai kembali

Mengembalikan jumlah karakter yang diambil dalam buffer yang ditunjukkan oleh lpNumberStr jika berhasil. Jika parameter cchNumber diatur ke 0, fungsi mengembalikan jumlah karakter yang diperlukan untuk menahan string angka yang diformat, termasuk karakter null yang mengakhiri.

Fungsi mengembalikan 0 jika tidak berhasil. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

ERROR_INSUFFICIENT_BUFFER. Ukuran buffer yang disediakan tidak cukup besar, atau salah diatur ke NULL.
ERROR_INVALID_FLAGS. Nilai yang diberikan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.
ERROR_OUTOFMEMORY. Penyimpanan tidak cukup tersedia untuk menyelesaikan operasi ini.

Keterangan

Dimulai di Windows 8: Jika aplikasi Anda meneruskan tag bahasa ke fungsi ini dari namespace Windows.Globalization, aplikasi harus terlebih dahulu mengonversi tag dengan memanggil ResolveLocaleName.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll

Lihat juga

GetNumberFormat

NUMBERFMT

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

Bagikan melalui