Fungsi vsnprintf () dalam C ++ digunakan untuk menulis rentetan berformat ke penyangga tali.
Tidak seperti vsprintf (), bilangan aksara maksimum yang boleh ditulis ke penyangga ditentukan dalam vsnprintf().
prototaip vsnprintf ()
int vsnprintf (char * buffer, size_t buf_size, const char * format, va_list vlist);
Yang vsnprintf()fungsi menulis rentetan yang ditunjukkan oleh format untuk penampan rentetan aksara. Bilangan maksimum aksara yang boleh ditulis adalah buf_size. Selepas watak ditulis, watak null penamat ditambahkan. Sekiranya buf_size sama dengan sifar, tidak ada yang ditulis dan penyangga mungkin penunjuk nol.
Format rentetan mungkin mengandungi penentu format yang dimulai dengan% yang digantikan oleh nilai-nilai pemboleh ubah yang dilewatkan sebagai senarai daftar.
Ia ditakrifkan dalam fail tajuk.
Parameter vsnprintf ()
- penyangga: Penunjuk ke rentetan watak untuk menulis hasilnya.
- buf_size: Bilangan maksimum aksara untuk ditulis.
- format: Penunjuk ke rentetan nol yang dihentikan yang ditulis ke aliran fail. Ia terdiri daripada watak-watak bersama dengan penentu format pilihan bermula dengan%.
Penentu format digantikan oleh nilai pemboleh ubah masing-masing yang mengikuti rentetan format.
Penentu format mempunyai bahagian berikut:
- Tanda% terkemuka
- Bendera: Pilihan satu atau lebih bendera yang mengubah tingkah laku penukaran.
- -: Kiri membenarkan hasilnya di lapangan. Secara lalai ia dibenarkan.
- +: Tanda hasil dilampirkan pada awal nilai, bahkan untuk hasil positif.
- Ruang: Sekiranya tidak ada tanda, ruang dilampirkan pada awal hasil.
- #: Satu bentuk penukaran alternatif dilakukan.
- 0: Digunakan untuk nombor bulat dan bilangan bulat. Nol sifar digunakan untuk menambah angka dan bukannya ruang.
- Lebar: Nilai * atau integer pilihan yang digunakan untuk menentukan medan lebar minimum.
- Ketepatan: Medan pilihan yang terdiri daripada a. diikuti oleh * atau bilangan bulat atau tidak ada yang menentukan ketepatan.
- Panjang: Pengubah panjang pilihan yang menentukan ukuran argumen.
- Penentu: Penentu format penukaran. Penentu format yang ada adalah seperti berikut:
Penentu Format Penerangan % Cetakan% c Menulis watak tunggal s Menulis rentetan watak d atau i Menukar bilangan bulat yang ditandakan menjadi perwakilan perpuluhan o Menukar bilangan bulat yang tidak bertanda kepada perwakilan oktal X atau x Menukar bilangan bulat yang tidak bertanda menjadi perwakilan heksadesimal awak Menukar bilangan bulat yang tidak bertanda menjadi perwakilan perpuluhan F atau f Menukar nombor titik terapung ke perwakilan perpuluhan E atau e Menukar nombor titik terapung ke notasi eksponen perpuluhan A atau a Menukar nombor titik terapung ke eksponen heksadesimal G atau g Menukar nombor titik terapung ke notasi eksponen perpuluhan atau perpuluhan n Mengembalikan jumlah watak yang ditulis sejauh ini oleh panggilan ini ke fungsi. Hasilnya ditulis berdasarkan nilai yang ditunjukkan oleh hujah hlm Menulis urutan watak yang ditentukan pelaksanaan yang menentukan penunjuk. Jadi format umum penentu format adalah:
%(flags)(width)(.precision)(length)specifier
- vlist: Senarai hujah yang mengandungi data untuk ditulis
vsnprintf () Nilai pulangan
- Sekiranya berjaya,
vsnprintf()fungsi mengembalikan bilangan watak yang ditulis. - Pada kegagalan ia mengembalikan nilai negatif.
- Apabila panjang tali yang diformat lebih besar daripada buf_size, ia perlu dipotong. Dalam kes seperti itu,
vsnprintf()fungsi mengembalikan jumlah aksara tidak termasuk watak null yang akan ditulis, sekiranya had buf_size tidak dikenakan.
Contoh: Bagaimana fungsi vsnprintf () berfungsi
#include #include void write(char* buf, int buf_size, const char *fmt,… ) ( va_list args; va_start(args, fmt); vsnprintf(buf, buf_size, fmt, args); va_end(args); ) int main () ( char buffer(100); char fname(20) = "Bjarne"; char lname(20) = "Stroustrup"; char lang(5) = "C++"; write(buffer, 27, "%s was created by %s %s", lang, fname, lname); printf("%s", buffer); return 0; )
Semasa anda menjalankan program, outputnya adalah:
C ++ dicipta oleh Bjarne
