Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje