std:: println (std::ostream)

Défini dans l'en-tête <ostream>
template < class ... Args > void println ( std:: ostream & os, std:: format_string < Args... > fmt, Args && ... args ) ;	(1)	(depuis C++23)
void println ( std:: ostream & os ) ;	(2)	(depuis C++26)

Formate args selon la chaîne de format fmt avec un ' \n ' ajouté (ce qui signifie que chaque sortie se termine par un saut de ligne), et insère le résultat dans le flux os .

Le comportement n'est pas défini si std:: formatter < Ti, char > ne satisfait pas aux exigences BasicFormatter pour tout Ti dans Args (comme requis par std:: make_format_args ).

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

Paramètres

os	-	flux de sortie dans lequel insérer les données
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 dans 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

Exceptions

• std::bad_alloc en cas d'échec d'allocation.
• Propage toute exception levée par un formatter , par exemple std::format_error , sans tenir compte de la valeur de os. exceptions ( ) et sans activer ios_base::badbit dans l'état d'erreur de os .
• Peut lever ios_base::failure causé par os. setstate ( ios_base :: badbit ) qui est appelé si une insertion dans os échoue.

Notes

Bien que la surcharge ( 2 ) soit ajoutée en C++26, toutes les implémentations connues la rendent disponible en mode C++23.

Macro de test de fonctionnalité	Valeur	Std	Fonctionnalité
__cpp_lib_print	202207L	(C++23)	Sortie formatée
__cpp_lib_format	202207L	(C++23)	Exposition de std::basic_format_string

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	S'applique à	Comportement publié	Comportement corrigé
LWG 4088	C++23	( 1 ) ignorait le locale appliqué à os dans le formatage des arguments	ce locale est utilisé

Voir aussi

print (std::ostream) (C++23)	affiche une représentation formatée des arguments (modèle de fonction)
println (C++23)	identique à std::print sauf que chaque affichage se termine par un saut de ligne supplémentaire (modèle de fonction)
format (C++20)	stocke la représentation formatée des arguments dans une nouvelle chaîne (modèle de fonction)