Функція vsnprintf () в C ++ використовується для запису відформатованого рядка в буфер рядків.
На відміну від vsprintf (), максимальна кількість символів, які можна записати в буфер, вказано в vsnprintf().
прототип vsnprintf ()
int vsnprintf (буфер char *, size_t buf_size, формат const char *, va_list vlist);
vsnprintf()Функція записує рядок , на яку вказує формат для рядка символів буфера. Максимальна кількість символів, яку можна записати, - buf_size. Після запису символів додається закінчувальний нульовий символ. Якщо buf_size дорівнює нулю, нічого не записується, а буфер може бути нульовим покажчиком.
Формат рядка може містити специфікатори формату, що починаються з%, які замінюються значеннями змінних, які передаються як список vlist.
Це визначається у файлі заголовка.
Параметри vsnprintf ()
- буфер: вказівник на рядок символів для запису результату.
- buf_size: Максимальна кількість символів для запису.
- формат: вказівник на рядок із нульовим завершенням, який записується у файловий потік. Він складається з символів разом із необов’язковими специфікаторами формату, що починаються з%.
Специфікатори формату замінюються значеннями відповідних змінних, що слідують за рядком формату.
Специфікатор формату складається з таких частин:
- Провідний знак%
- Прапори: необов’язковий один або кілька прапорів, що змінює поведінку перетворення.
- -: Ліворуч обґрунтуйте результат у полі. За замовчуванням це правильно виправдано.
- +: Знак результату додається до початку значення, навіть для позитивних результатів.
- Пробіл: Якщо знаку немає, пробіл приєднується до початку результату.
- #: Виконується альтернативна форма перетворення.
- 0: використовується для цілого числа та числа з плаваючою комою. Провідні нулі використовуються для заповнення цифр замість пробілу.
- Ширина: необов’язкове * або ціле значення, що використовується для вказівки поля мінімальної ширини.
- Точність: Необов’язкове поле, що складається з a. після чого * або ціле число, або нічого, щоб вказати точність.
- Довжина: необов’язковий модифікатор довжини, який визначає розмір аргументу.
- Специфікатор: специфікатор формату перетворення. Доступні специфікатори формату такі:
Специфікатор формату Опис % Відбитків% c Пише одного персонажа s Записує рядок символів d або i Перетворює підписане ціле число в десяткове подання o Перетворює ціле число без знака у вісімкове представлення X або x Перетворює ціле число без знака в шістнадцяткове подання u Перетворює ціле число без знака в десяткове подання F або f Перетворює число з плаваючою точкою в десяткове подання Е або е Перетворює число з плаваючою комою в десятковий запис степеня A або a Перетворює число з плаваючою комою в шістнадцятковий показник G або g Перетворює число з плаваючою комою в десятковий або десятковий запис степеня п Повертає кількість символів, записаних дотепер цим викликом функції. Результат записується у значення, на яке вказує аргумент стор Пише послідовність символів реалізації, що визначає покажчик. Отже, загальним форматом специфікатора формату є:
%(flags)(width)(.precision)(length)specifier
- vlist: список аргументів, що містять дані для запису.
vsnprintf () Повернене значення
- У разі успіху
vsnprintf()функція повертає кількість записаних символів. - При відмові повертає від'ємне значення.
- Коли довжина відформатованого рядка перевищує buf_size, його потрібно скоротити. У таких випадках
vsnprintf()функція повертає загальну кількість символів, за винятком закінчувального нульового символу, який був би записаний, якби не було встановлено обмеження buf_size.
Приклад: Як працює функція vsnprintf ()
#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; )
Коли ви запускаєте програму, результат буде:
C ++ був створений Bjarne
