Функцията 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. последвано от * или цяло число или нищо, за да се определи точността.
- Дължина: Незадължителен модификатор на дължина, който указва размера на аргумента.
- Спецификатор: Спецификатор на формат за преобразуване. Наличните спецификатори на формата са както следва:
Форматизатор Описание % % Разпечатки ° С Пише един знак с Пише низ от символи d или i Преобразува подписано цяло число в десетично представяне o Преобразува неподписано цяло число в осмично представяне X или x Преобразува неподписано цяло число в шестнадесетично представяне u Преобразува неподписано цяло число в десетично представяне F или f Преобразува число с плаваща запетая в десетично представяне E или e Преобразува число с плаваща запетая в десетична степенна нотация 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