База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници