std:: vformat_to

Défini dans l'en-tête <format>
template < class OutputIt > OutputIt vformat_to ( OutputIt out, std:: string_view fmt, std:: format_args args ) ;	(1)	(depuis C++20)
template < class OutputIt > OutputIt vformat_to ( OutputIt out, std:: wstring_view fmt, std:: wformat_args args ) ;	(2)	(depuis C++20)
template < class OutputIt > OutputIt vformat_to ( OutputIt out, const std:: locale & loc, std:: string_view fmt, std:: format_args args ) ;	(3)	(depuis C++20)
template < class OutputIt > OutputIt vformat_to ( OutputIt out, const std:: locale & loc, std:: wstring_view fmt, std:: wformat_args args ) ;	(4)	(depuis C++20)

Formate les arguments contenus dans args selon la chaîne de format fmt , et écrit le résultat dans l'itérateur de sortie out . Si présent, loc est utilisé pour le formatage spécifique à la locale.

Soit CharT le type decltype ( fmt ) :: char_type ( char pour les surcharges (1,3) , wchar_t pour les surcharges (2,4) ).

Ces surcharges participent à la résolution de surcharge seulement si OutputIt satisfait le concept std:: output_iterator < const CharT & > .

OutputIt doit modéliser (satisfaire aux exigences sémantiques du) concept std:: output_iterator < const CharT & > , et std:: formatter < Ti, CharT > doit satisfaire aux exigences Formatter pour tout Ti dans le type des arguments. Sinon, le comportement est indéfini.

Table des matières 1 Paramètres 2 Valeur de retour 3 Exceptions 4 Exemple 5 Rapports de défauts 6 Voir aussi

Paramètres

out	-	itérateur vers le tampon de sortie
fmt	-	un objet qui représente la chaîne de format. La chaîne de format est constituée de caractères ordinaires (sauf { et } ), qui sont copiés inchangés vers la sortie, séquences d'échappement { { et } } , qui sont remplacées respectivement par { et } dans la sortie, et champs de remplacement. Chaque champ de remplacement a le format suivant : { arg-id (optionnel) } (1) { arg-id (optionnel) : format-spec } (2) 1) champ de remplacement sans spécification de format 2) champ de remplacement avec spécification de format arg-id - spécifie l'index de l'argument dans args dont la valeur doit être utilisée pour le formatage ; s'il est omis, les arguments sont utilisés dans l'ordre. Les arg-id  dans une chaîne de format doivent tous être présents ou tous être omis. Mélanger l'indexation manuelle et automatique est une erreur. format-spec - la spécification de format définie par la spécialisation std::formatter pour l'argument correspondant. Ne peut pas commencer par } . Pour les types de base et les types de chaîne standard, la spécification de format est interprétée comme spécification de format standard . Pour les types chrono, la spécification de format est interprétée comme spécification de format chrono . Pour les types de plage, la spécification de format est interprétée comme spécification de format de plage . Pour std::pair et std::tuple , la spécification de format est interprétée comme spécification de format de tuple . Pour std::thread::id et std::stacktrace_entry , voir spécification de format d'identifiant de thread et spécification de format d'entrée de pile d'appels . Pour std::basic_stacktrace , aucun spécificateur de format n'est autorisé. (depuis C++23) Pour std::filesystem::path , voir spécification de format de chemin . (depuis C++26) Pour les autres types formatables, la spécification de format est déterminée par les spécialisations formatter définies par l'utilisateur.
args	-	arguments à formater
loc	-	std::locale utilisé pour le formatage spécifique à la locale

Valeur de retour

Itérateur au-delà de la fin de la plage de sortie.

Exceptions

Lance std::format_error si fmt n'est pas une chaîne de format valide pour les arguments fournis. Propage également toute exception levée par les opérations de formateur ou d'itérateur.

Exemple

Cette section est incomplète Raison : aucun exemple

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

DR	Appliqué à	Comportement publié	Comportement correct
P2216R3	C++20	le type de args est paramétré sur OutputIt	non paramétré

Voir aussi