Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::vformat — formátovanie pomocou formátovacieho reťazca určeného za behu

std::vformat z <format> vytvára reťazec z formátovacieho reťazca a balíka argumentov std::format_args. Prijíma vzor určený za behu a neplatné formátovanie pre zadané argumenty oznamuje pomocou std::format_error.

Verzia: C++23; repository compiler flag, production runtime not attested

Syntax

#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 vracia nový reťazec namiesto zapisovania do prúdu. Prijíma formátovací reťazec a balík argumentov s vymazanými typmi. Preťaženie s std::string_view vracia std::string; preťaženie s std::wstring_view používa std::wformat_args a vracia std::wstring. Preťaženia prijímajúce std::locale podporujú formátovanie závislé od miestnych nastavení.

V C++23 std::format zvyčajne kontroluje formátovací reťazec pri kompilácii. Naproti tomu std::vformat prijíma vzor dostupný až za behu. Neplatná syntax, chýbajúci odkazovaný argument alebo špecifikátor nekompatibilný s typom argumentu spôsobí std::format_error. Z volania môžu uniknúť aj výnimky z formátovačov a chyby pri alokácii.

Balík vytvorte pomocou std::make_format_args a pomenovaných premenných. Nepovažujte ho za vlastníka všetkých hodnôt: môže uchovávať odkazy na údaje argumentov. Tieto údaje musia zostať platné až do skončenia formátovania a samotné std::format_args nepredlžuje životnosť úložiska vytvoreného pomocou std::make_format_args. Priame odovzdanie tohto úložiska do volania, ako v príklade, zabráni jeho predčasnému zničeniu.

V príklade {} vloží label, zatiaľ čo {:04d} zapíše count v desiatkovej sústave s minimálnou šírkou štyroch znakov a úvodnými nulami. Výstup je item: 0007 nasledovaný novým riadkom. Tento záznam sa týka C++23; uvedený odkaz smeruje na vyvíjajúci sa pracovný návrh, ktorý môže obsahovať neskoršie zmeny. Príznak kompilátora v repozitári nedokazuje dostupnosť knižnice v produkčnom prostredí.

Prí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ýsledok

item: 0007

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje