CKTIS / C++
std::format_to: formatação por iterador de saída
std::format_to escreve caracteres formatados através de um iterador de saída e devolve o iterador após a última escrita.
Versão: C++23
Sintaxe
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...) de <format> formata como std::format, mas não cria uma cadeia de resultado: atribui caracteres sucessivos através de out. O retorno é o iterador imediatamente após o último carácter escrito. Há formas para caracteres estreitos e largos, além de sobrecargas que recebem std::locale.
O exemplo escreve "2 + 3 = 5" no início de um array de caracteres e subtrai o início ao iterador devolvido para obter 9 caracteres, imprimindo 2 + 3 = 5|9. Não acrescenta terminador nulo; a view recebe um comprimento explícito. Para um contentor expansível, std::back_inserter é o destino habitual.
O iterador de destino tem de aceitar o tipo de carácter correto e permanecer gravável durante todo o resultado. Num buffer insuficiente, um iterador comum deixa de cumprir os requisitos de iterador de saída e escritas posteriores têm comportamento indefinido; format_to não conhece a capacidade. Um format_string literal é verificado contra os argumentos. Falhas podem lançar std::format_error, a alocação std::bad_alloc, e exceções do formatter ou iterador propagam-se. Usa std::format_to_n quando for necessário limitar a escrita.
Exemplos
#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';
}
Resultado
2 + 3 = 5|9
std::format_to → 2 + 3 = 5|9