CKTIS / C++
std::vformat — oblikovanje pomoću formatnog niza određenog tijekom izvođenja
std::vformat iz <format> izrađuje niz iz formatnog niza i paketa argumenata std::format_args. Prihvaća uzorak određen tijekom izvođenja i neispravno oblikovanje za zadane argumente prijavljuje pomoću std::format_error.
Verzija: C++23; repository compiler flag, production runtime not attested
Sintaksa
#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 vraća novi niz umjesto zapisivanja u tok. Prihvaća formatni niz i paket argumenata s izbrisanim tipovima. Preopterećenje sa std::string_view vraća std::string; preopterećenje sa std::wstring_view upotrebljava std::wformat_args i vraća std::wstring. Preopterećenja koja primaju std::locale podržavaju oblikovanje ovisno o regionalnim postavkama.
U C++23 std::format obično provjerava formatni niz tijekom kompilacije. Nasuprot tome, std::vformat prihvaća uzorak dostupan tek tijekom izvođenja. Neispravna sintaksa, nedostajući referencirani argument ili specifikator neusklađen s tipom argumenta uzrokuje std::format_error. Iz poziva mogu izaći i iznimke iz formatirača te pogreške pri alokaciji.
Paket izradite pomoću std::make_format_args i imenovanih varijabli. Nemojte ga smatrati vlasnikom svih vrijednosti: može čuvati reference na podatke argumenata. Ti podaci moraju ostati valjani do završetka oblikovanja, a sam std::format_args ne produljuje životni vijek spremišta koje stvara std::make_format_args. Izravna predaja tog spremišta pozivu, kao u primjeru, sprječava njegovo prerano uništavanje.
U primjeru {} umeće label, dok {:04d} zapisuje count u decimalnom obliku s najmanjom širinom od četiri znaka i početnim nulama. Izlaz je item: 0007, nakon čega slijedi novi redak. Ovaj se unos odnosi na C++23; navedena referenca vodi do radnog nacrta koji se mijenja i može sadržavati kasnije izmjene. Zastavica prevoditelja u repozitoriju ne dokazuje dostupnost biblioteke u produkcijskom okruženju.
Primjeri
#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';
}
Rezultat
item: 0007
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.