Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C++

std::format_to: formatiranje preko izlaznog iteratora

std::format_to zapisuje formatirane znakove preko izlaznog iteratora i vraća iterator iza posljednjeg zapisa.

Verzija: 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> formatira kao std::format, ali ne stvara rezultirajući string: uzastopne znakove pridružuje preko out. Povratna vrijednost pokazuje neposredno iza posljednjeg zapisanog znaka. Postoje uske i široke inačice te preopterećenja sa std::locale.

Primjer zapisuje "2 + 3 = 5" na početak polja znakova i razlikom vraćenog iteratora i početka dobiva 9 znakova, pa ispisuje 2 + 3 = 5|9. Nulti završni znak ne dodaje se; view dobiva izričitu duljinu. Za rastući spremnik uobičajeno je odredište std::back_inserter.

Odredišni iterator mora prihvaćati pravi tip znaka i ostati zapisiv za cijeli rezultat. U premalom međuspremniku običan iterator više ne zadovoljava zahtjeve izlaznog iteratora i daljnje pisanje ima nedefinirano ponašanje; format_to ne zna kapacitet. Doslovni format_string provjerava se prema argumentima. Pogreške mogu baciti std::format_error, alokacija std::bad_alloc, a iznimke formattera ili iteratora propagiraju se. Za ograničen zapis služi std::format_to_n.

Primjeri

#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

Izvori