База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::format_to: форматиране чрез изходен итератор

std::format_to записва форматирани знаци чрез изходен итератор и връща итератора след последния запис.

Версия: C++23

Синтаксис

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...) от <format> форматира като std::format, но не създава резултатен низ: присвоява последователните знаци чрез out. Върнатата стойност сочи непосредствено след последния записан знак. Има тесни и широки варианти и претоварвания със std::locale.

Примерът записва "2 + 3 = 5" в началото на масив от знаци и чрез разликата между върнатия итератор и началото получава 9 знака, затова извежда 2 + 3 = 5|9. Не се добавя нулев завършващ знак; view получава явна дължина. За растящ контейнер обичайната цел е std::back_inserter.

Целевият итератор трябва да приема правилния тип знак и да остане годен за запис за целия резултат. В твърде малък буфер обикновеният итератор престава да покрива изискванията за изходен итератор и последващият запис има неопределено поведение; format_to не знае капацитета. Литерален format_string се проверява спрямо аргументите. Грешките могат да хвърлят std::format_error, алокацията std::bad_alloc, а изключенията от formatter или итератора се разпространяват. За лимит използвайте std::format_to_n.

Примери

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

Резултат

2 + 3 = 5|9

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

Източници