Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::format_to : formatage vers un itérateur de sortie

std::format_to écrit les caractères formatés via un itérateur de sortie et renvoie l’itérateur après la dernière écriture.

Version : C++23

Syntaxe

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> formate les arguments comme std::format, sans créer de chaîne résultat : il affecte les caractères successifs via out. La valeur renvoyée est l’itérateur immédiatement après le dernier caractère écrit. Il existe des formes étroites et larges, ainsi que des surcharges recevant std::locale.

L’exemple écrit "2 + 3 = 5" au début d’un tableau de caractères et soustrait son début de l’itérateur renvoyé pour obtenir 9 caractères ; il affiche donc 2 + 3 = 5|9. Aucun caractère nul n’est ajouté : la vue reçoit une longueur explicite. Pour un conteneur extensible, std::back_inserter est la destination habituelle.

L’itérateur cible doit accepter le type de caractère approprié et rester inscriptible pendant tout le résultat. Dans un tampon trop petit, un itérateur ordinaire cesse de satisfaire les exigences d’itérateur de sortie et toute écriture ultérieure est indéfinie ; format_to ignore la capacité. Un format_string littéral est vérifié avec les arguments. Les erreurs peuvent lancer std::format_error, l’allocation std::bad_alloc, et les exceptions du formatter ou de l’itérateur se propagent. Utilisez std::format_to_n pour limiter l’écriture.

Exemples

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

Résultat

2 + 3 = 5|9

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

Sources