Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori