Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes