Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::format_to: formattazione tramite iteratore di output

std::format_to scrive caratteri formattati tramite un iteratore di output e restituisce l’iteratore dopo l’ultima scrittura.

Versione: C++23

Sintassi

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...) di <format> formatta come std::format, ma non crea una stringa risultato: assegna i caratteri successivi tramite out. Il valore restituito è l’iteratore immediatamente successivo all’ultimo carattere scritto. Esistono forme per caratteri stretti e larghi e overload che accettano std::locale.

L’esempio scrive "2 + 3 = 5" all’inizio di un array di caratteri e sottrae l’inizio dall’iteratore restituito, ottenendo 9 caratteri; stampa quindi 2 + 3 = 5|9. Non viene aggiunto il terminatore nullo: la view riceve una lunghezza esplicita. Per un contenitore espandibile la destinazione abituale è std::back_inserter.

L’iteratore di destinazione deve accettare il tipo di carattere corretto e restare scrivibile per tutto il risultato. In un buffer troppo piccolo, un iteratore normale smette di soddisfare i requisiti di output iterator e le scritture successive hanno comportamento indefinito; format_to non conosce la capacità. Un format_string letterale è controllato rispetto agli argomenti. Gli errori possono lanciare std::format_error, l’allocazione std::bad_alloc; le eccezioni del formatter o dell’iteratore si propagano. Per limitare la scrittura usa std::format_to_n.

Esempi

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

Risultato

2 + 3 = 5|9

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

Fonti