fungsi wvsprintfA (winuser.h)

Artikel
20/11/2024

Menulis data yang diformat ke buffer yang ditentukan menggunakan penunjuk ke daftar argumen. Item yang ditujukkan oleh daftar argumen dikonversi dan disalin ke buffer output sesuai dengan spesifikasi format yang sesuai dalam string kontrol format. Fungsi ini menambahkan karakter null yang mengakhiri ke karakter yang ditulisnya, tetapi nilai yang dikembalikan tidak menyertakan karakter null yang mengakhiri dalam jumlah karakternya.

Peringatan Jangan gunakan. Pertimbangkan untuk menggunakan salah satu fungsi berikut sebagai gantinya: StringCbVPrintf, StringCbVPrintfEx, StringCchVPrintf, atau StringCchVPrintfEx. Lihat Pertimbangan Keamanan.

Sintaksis

C++

int wvsprintfA(
  [out] LPSTR   unnamedParam1,
  [in]  LPCSTR  unnamedParam2,
  [in]  va_list arglist
);

Parameter

[out] unnamedParam1

Jenis: LPTSTR

Buffer yang menerima output yang diformat. Ukuran maksimum buffer adalah 1.024 byte.

[in] unnamedParam2

Jenis: LPCTSTR

Spesifikasi kontrol format. Selain karakter ASCII biasa, spesifikasi format untuk setiap argumen muncul dalam string ini. Untuk informasi selengkapnya tentang spesifikasi format, lihat fungsi wsprintf .

[in] arglist

Jenis: va_list

Setiap elemen daftar ini menentukan argumen untuk string kontrol format. Jumlah, jenis, dan interpretasi argumen bergantung pada spesifikasi kontrol format yang sesuai dalam parameter lpFmt .

Mengembalikan nilai

Jenis: int

Jika fungsi berhasil, nilai pengembalian adalah jumlah karakter yang disimpan dalam buffer, tidak menghitung karakter null yang mengakhiri.

Jika fungsi gagal, nilai pengembalian kurang dari panjang output yang diharapkan. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Fungsi menyalin string kontrol format ke dalam karakter buffer output berdasarkan karakter, dimulai dengan karakter pertama dalam string. Ketika menemukan spesifikasi format dalam string, fungsi mengambil nilai argumen berikutnya yang tersedia (dimulai dengan argumen pertama dalam daftar), mengonversi nilai tersebut ke dalam format yang ditentukan, dan menyalin hasilnya ke buffer output. Fungsi terus menyalin karakter dan memperluas spesifikasi format dengan cara ini hingga mencapai akhir string kontrol format. Jika ada lebih banyak argumen daripada spesifikasi format, argumen tambahan diabaikan. Jika tidak ada cukup argumen untuk semua spesifikasi format, hasilnya tidak ditentukan.

Catatan

Header winuser.h mendefinisikan wvsprintf sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

Konseptual

Referensi

StringCbPrintf

StringCbPrintfEx

StringCbVPrintf

StringCbVPrintfEx

StringCchPrintf

StringCchPrintfEx

StringCchVPrintf

StringCchVPrintfEx

String

wsprintf

Bagikan melalui