CKTIS / C++
std::vformat — formátování pomocí formátovacího řetězce určeného za běhu
std::vformat z <format> vytváří řetězec z formátovacího řetězce a balíčku argumentů std::format_args. Přijímá vzor určený za běhu a neplatné formátování pro zadané argumenty oznamuje pomocí std::format_error.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 vrací nový řetězec, místo aby zapisoval do proudu. Přijímá formátovací řetězec a balíček argumentů s vymazanými typy. Přetížení s std::string_view vrací std::string; přetížení s std::wstring_view používá std::wformat_args a vrací std::wstring. Přetížení přijímající std::locale podporují formátování závislé na národním prostředí.
V C++23 std::format obvykle kontroluje formátovací řetězec při kompilaci. Naproti tomu std::vformat přijímá vzor, který je dostupný až za běhu. Neplatná syntaxe, chybějící odkazovaný argument nebo specifikátor nekompatibilní s typem argumentu způsobí std::format_error. Z volání mohou také uniknout výjimky z formátovačů a chyby při alokaci.
Balíček vytvořte pomocí std::make_format_args a pojmenovaných proměnných. Nepovažujte jej za vlastníka všech hodnot: může uchovávat odkazy na data argumentů. Tato data musejí zůstat platná až do dokončení formátování a samotné std::format_args neprodlužuje životnost úložiště vytvořeného pomocí std::make_format_args. Předání tohoto úložiště přímo do volání, jako v příkladu, zabrání jeho předčasnému zániku.
V příkladu {} vloží label, zatímco {:04d} zapíše count v desítkové soustavě s minimální šířkou čtyř znaků a počátečními nulami. Výstup je item: 0007 následovaný novým řádkem. Tento záznam se vztahuje k C++23; uvedený odkaz vede na vyvíjející se pracovní návrh, který může obsahovat pozdější změny. Příznak kompilátoru v repozitáři nedokládá dostupnost knihovny v produkčním prostředí.
Příklady
#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';
}
Výsledek
item: 0007
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.