KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::format_to: formatteren via een uitvoeriterator

std::format_to schrijft opgemaakte tekens via een uitvoeriterator en retourneert de iterator na de laatste schrijfoperatie.

Versie: 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...) uit <format> formatteert zoals std::format, maar maakt geen resultaatstring: opeenvolgende tekens worden via out toegewezen. De retourwaarde wijst direct achter het laatst geschreven teken. Er zijn smalle en brede vormen en overloads die std::locale aannemen.

Het voorbeeld schrijft "2 + 3 = 5" aan het begin van een tekenarray en trekt het begin af van de geretourneerde iterator om 9 tekens te krijgen; het print 2 + 3 = 5|9. Er wordt geen nulterminator toegevoegd, dus de view krijgt een expliciete lengte. Voor een groeiende container is std::back_inserter de gebruikelijke bestemming.

De doeliterator moet het juiste tekentype aannemen en voor het hele resultaat beschrijfbaar blijven. In een te kleine buffer voldoet een gewone iterator niet langer aan de uitvoeriteratorvereisten en hebben verdere schrijfacties ongedefinieerd gedrag; format_to kent de capaciteit niet. Een letterlijke format_string wordt tegen de argumenten gecontroleerd. Fouten kunnen std::format_error en allocatie std::bad_alloc opleveren; formatter- en iteratorexcepties worden doorgegeven. Gebruik std::format_to_n voor een schrijflimiet.

Voorbeelden

#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';
}

Resultaat

2 + 3 = 5|9

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

Bronnen