Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::format_to: oblikovanje prek izhodnega iteratorja

std::format_to zapisuje oblikovane znake prek izhodnega iteratorja in vrne iterator za zadnjim zapisom.

Različica: C++23

Sintaksa

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...) iz <format> oblikuje kot std::format, vendar ne ustvari rezultatskega niza: zaporedne znake prireja prek out. Vrnjena vrednost kaže neposredno za zadnji zapisani znak. Obstajajo ozke in široke oblike ter preobremenitve s std::locale.

Primer zapiše "2 + 3 = 5" na začetek polja znakov in z razliko med vrnjenim iteratorjem ter začetkom dobi 9 znakov, zato izpiše 2 + 3 = 5|9. Ničelni zaključni znak se ne doda; view dobi izrecno dolžino. Za rastoči vsebnik je običajen cilj std::back_inserter.

Ciljni iterator mora sprejemati pravi tip znaka in ostati zapisljiv za ves rezultat. V premajhnem medpomnilniku navaden iterator ne izpolnjuje več zahtev izhodnega iteratorja in nadaljnje pisanje ima nedefinirano vedenje; format_to zmogljivosti ne pozna. Dobesedni format_string se preveri z argumenti. Napake lahko vržejo std::format_error, dodelitev std::bad_alloc, izjeme formatterja ali iteratorja pa se razširijo. Za omejitev zapisa uporabi std::format_to_n.

Primeri

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

Rezultat

2 + 3 = 5|9

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

Viri