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

CKTIS / C++

std::format_to: formátování přes výstupní iterátor

std::format_to zapisuje formátované znaky přes výstupní iterátor a vrací iterátor za posledním zápisem.

Verze: C++23

Syntaxe

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 jako std::format, ale nevytváří výsledný řetězec: postupné znaky přiřazuje přes out. Návratová hodnota ukazuje bezprostředně za poslední zapsaný znak. Existují úzké i široké varianty a přetížení s std::locale.

Příklad zapíše "2 + 3 = 5" na začátek pole znaků a rozdílem vráceného iterátoru a začátku získá 9 znaků, proto vypíše 2 + 3 = 5|9. Nulový ukončovací znak se nepřidává; view dostane výslovnou délku. Pro rostoucí kontejner je obvyklým cílem std::back_inserter.

Cílový iterátor musí přijímat správný typ znaku a zůstat zapisovatelný pro celý výsledek. V příliš malém bufferu přestane běžný iterátor splňovat požadavky výstupního iterátoru a další zápis má nedefinované chování; format_to kapacitu nezná. Literální format_string se kontroluje proti argumentům. Chyby mohou vyvolat std::format_error, alokace std::bad_alloc a výjimky formatteru či iterátoru se šíří. Pro omezený zápis slouží std::format_to_n.

Pří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ýsledek

2 + 3 = 5|9

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

Zdroje