Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::format: tipizirano formatiranje u novi niz

std::format stvara novi std::string iz provjerenog formatnog uzorka i argumenata.

Verzija: C++23

Sintaksa

template<class... Args>
std::string std::format(std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(std::wformat_string<Args...> fmt, Args&&... args);

template<class... Args>
std::string std::format(const std::locale& loc,
    std::format_string<Args...> fmt, Args&&... args);

template<class... Args>
std::wstring std::format(const std::locale& loc,
    std::wformat_string<Args...> fmt, Args&&... args);

std::format(fmt, args...) iz <format> vraća novi std::string s prikazima argumenata u zamjenskim poljima; širokoznakovna inačica vraća std::wstring, a dodatna preopterećenja primaju std::locale. U C++23 običan poziv koristi format_string<Args...>, čiji se literal pri prevođenju provjerava prema broju i tipovima argumenata.

Primjer formatira 7 kao 0007, 3.5 s dvije decimalne znamenke i udvostručene vitičaste zagrade kao doslovan tekst te ispisuje 0007 3.50 {ok}. {} bira sljedeći argument, a dio iza : upravlja poravnanjem, širinom, preciznošću i vrstom prikaza. std::format vraća zaseban niz; std::format_to piše kroz izlazni iterator.

Doslovne zagrade pišu se {{ i }}; automatsko {} i ručno {0} numeriranje ne smiju se miješati. Nevaljan literal ili tipski nekompatibilan specifikator obično čini poziv neispravnim već pri prevođenju. Za uzorak poznat tek tijekom izvođenja koristi std::vformat. I std::format može baciti std::format_error za pogrešku ovisnu o vrijednosti otkrivenu tijekom izvođenja, primjerice nevaljanu dinamičku širinu ili preciznost; iznimke operacija formattera propagiraju se, a alokacija može baciti std::bad_alloc. Vlastiti tip zahtijeva valjanu specijalizaciju std::formatter; regionalno formatiranje koristi preopterećenje std::locale i odgovarajuće opcije.

Primjeri

#include <format>
#include <iostream>

int main() {
    std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}

Rezultat

0007 3.50 {ok}

std::format → 0007 3.50 {ok}

Izvori