Fungsi StrFormatByteSizeA (shlwapi.h)
Mengonversi nilai numerik menjadi string yang mewakili angka yang dinyatakan sebagai nilai ukuran dalam byte, kilobyte, megabyte, atau gigabyte, tergantung pada ukurannya. Berbeda dari StrFormatByteSizeW dalam satu jenis parameter.
Sintaks
PSTR StrFormatByteSizeA(
DWORD dw,
[out] PSTR pszBuf,
UINT cchBuf
);
Parameter
dw
Jenis: DWORD
Nilai numerik yang akan dikonversi.
[out] pszBuf
Jenis: PSTR
Penunjuk ke buffer yang menerima string yang dikonversi.
cchBuf
Jenis: UINT
Ukuran buffer yang diacu oleh pszBuf, dalam karakter.
Menampilkan nilai
Jenis: PSTR
Mengembalikan penunjuk ke string yang dikonversi, atau NULL jika konversi gagal.
Keterangan
Parameter pertama dari fungsi ini memiliki jenis yang berbeda untuk versi ANSI dan Unicode. Jika nilai numerik Anda adalah DWORD, Anda dapat menggunakan StrFormatByteSize dengan makro teks untuk kedua kasus. Pengkompilasi akan melemparkan nilai numerik ke LONGLONG untuk kasus Unicode. Jika nilai numerik Anda adalah LONGLONG, Anda harus menggunakan StrFormatByteSizeW secara eksplisit.
Dalam Windows 10, ukuran dilaporkan dalam basis 10 daripada basis 2. Misalnya, 1 KB adalah 1000 byte daripada 1024.
Tabel berikut ini menggambarkan bagaimana fungsi ini mengonversi nilai numerik menjadi string teks.
| Nilai numerik | String teks |
|---|---|
| 532 | 532 byte |
| 1340 | 1,30 KB |
| 23506 | 22,9 KB |
| 2400016 | 2,28 MB |
| 2400000000 | 2,23 GB |
Catatan
Header shlwapi.h mendefinisikan StrFormatByteSize sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional, Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shlwapi.h |
| Pustaka | Shlwapi.lib |
| DLL | Shlwapi.dll (versi 4.71 atau yang lebih baru) |