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

CKTIS / C++

std::format_to: formátovanie cez výstupný iterátor

std::format_to zapisuje formátované znaky cez výstupný iterátor a vracia iterátor za posledným zápisom.

Verzia: C++23

Syntax

template<class Out, class... Args>
Out std::format_to(Out out, std::format_string<Args...> fmt, Args&&... args);

template<class Out, class... Args>
Out std::format_to(Out out, std::wformat_string<Args...> fmt, Args&&... args);

template<class Out, class... Args>
Out std::format_to(Out out, const std::locale& loc,
    std::format_string<Args...> fmt, Args&&... args);

template<class Out, class... Args>
Out std::format_to(Out out, const std::locale& loc,
    std::wformat_string<Args...> fmt, Args&&... args);

std::format_to(out, fmt, args...) z <format> formátuje ako std::format, ale nevytvára výsledný reťazec: postupné znaky priraďuje cez out. Návratová hodnota ukazuje bezprostredne za posledný zapísaný znak. Existujú úzke aj široké varianty a preťaženia s std::locale.

Príklad zapíše "2 + 3 = 5" na začiatok poľa znakov a rozdielom vráteného iterátora a začiatku získa 9 znakov, preto vypíše 2 + 3 = 5|9. Nulový ukončovací znak sa nepridáva; view dostane výslovnú dĺžku. Pre rastúci kontajner je bežným cieľom std::back_inserter.

Cieľový iterátor musí prijímať správny typ znaku a zostať zapisovateľný pre celý výsledok. V primalom bufferi prestane bežný iterátor spĺňať požiadavky výstupného iterátora a ďalší zápis má nedefinované správanie; format_to kapacitu nepozná. Literálny format_string sa kontroluje proti argumentom. Chyby môžu vyvolať std::format_error, alokácia std::bad_alloc a výnimky formattera či iterátora sa šíria. Na obmedzený zápis slúži std::format_to_n.

Príklady

#include <array>
#include <format>
#include <iostream>
#include <string_view>

int main() {
    std::array<char, 32> buffer{};
    const auto end = std::format_to(buffer.begin(), "{} + {} = {}", 2, 3, 5);
    const std::string_view result(buffer.data(), end - buffer.begin());
    std::cout << result << '|' << result.size() << '\n';
}

Výsledok

2 + 3 = 5|9

std::format_to → 2 + 3 = 5|9

Zdroje