CKTIS / C++
std::vformat — форматиране с форматен низ, определен по време на изпълнение
std::vformat от <format> създава низ от форматен низ и пакет аргументи std::format_args. Приема шаблон, определен по време на изпълнение, и съобщава чрез std::format_error за невалидно форматиране на подадените аргументи.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#include <format>
std::string std::vformat(std::string_view fmt, std::format_args args);
std::wstring std::vformat(std::wstring_view fmt, std::wformat_args args);
std::string std::vformat(const std::locale& loc, std::string_view fmt, std::format_args args);
std::wstring std::vformat(const std::locale& loc, std::wstring_view fmt, std::wformat_args args);std::vformat връща нов низ, вместо да записва в поток. Приема форматен низ и пакет аргументи с изтрити типове. Претоварването със std::string_view връща std::string; това със std::wstring_view използва std::wformat_args и връща std::wstring. Претоварванията, които приемат std::locale, поддържат форматиране според локалните настройки.
В C++23 std::format обикновено проверява форматния си низ по време на компилация. За разлика от него std::vformat приема шаблон, който е наличен едва по време на изпълнение. Невалиден синтаксис, липсващ посочен аргумент или спецификатор, несъвместим с типа на аргумента, причинява std::format_error. От извикването могат да излязат и изключения от форматери, както и грешки при заделяне на памет.
Създавайте пакета чрез std::make_format_args с именувани променливи. Не го приемайте за собственик на всички стойности: той може да съхранява препратки към данните на аргументите. Тези данни трябва да останат валидни до приключване на форматирането, а самият std::format_args не удължава живота на хранилището, създадено от std::make_format_args. Подаването на това хранилище директно на извикването, както е в примера, предотвратява преждевременното му унищожаване.
В примера {} вмъква label, а {:04d} записва count в десетичен вид с минимална ширина четири знака и водещи нули. Резултатът е item: 0007, последван от нов ред. Тази статия е за C++23; посочената справка води към развиващ се работен проект, който може да съдържа по-късни промени. Флаг на компилатора в хранилище не доказва, че библиотеката е налична в производствената среда.
Примери
#include <format>
#include <iostream>
#include <string>
int main() {
std::string pattern = "{}: {:04d}";
std::string label = "item";
int count = 7;
std::string result = std::vformat(
pattern, std::make_format_args(label, count));
std::cout << result << '\n';
}
Резултат
item: 0007
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.