std:: vprint_unicode (std::ostream)

Défini dans l'en-tête <ostream>
void vprint_unicode ( std:: ostream & os, std:: string_view fmt, std:: format_args args ) ;		(depuis C++23)

Formate args selon la chaîne de format fmt , et écrit le résultat dans le flux de sortie os . Se comporte comme une FormattedOutputFunction de os , sauf que certains détails du signalement d'erreur diffèrent .

Effectue les opérations suivantes dans l'ordre :

1. Premièrement, la fonction construit et vérifie l'objet sentry .
2. Initialise une variable automatique comme si par std:: string out = std:: vformat ( os. getloc ( ) , fmt, args ) ; .
3. Écrit out vers os :

• Si os fait référence à un terminal qui ne peut afficher Unicode que via une API Unicode native , vide le tampon de os et écrit out sur le terminal en utilisant l'API Unicode native.
• Sinon, insère la séquence de caractères [ out. begin ( ) , out. end ( ) ) dans os .

Si l'écriture vers le terminal ou l'insertion dans os échoue, appelle os. setstate ( std:: ios_base :: badbit ) .

Après avoir écrit des caractères dans os , établit un point de contrôle observable .

(since C++26)

Si out contient des unités de code Unicode non valides lorsque l'API Unicode native est utilisée, le comportement est indéfini.

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

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 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 s 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

Si l'invocation de l'API Unicode native nécessite un transcodage, les unités de code non valides sont remplacées par U+FFFD CARACTÈRE DE REMPLACEMENT (voir "The Unicode Standard - Core Specification", Chapitre 3.9 ).

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	Applied to	Behavior as published	Correct behavior
LWG 4044	C++23	l'API Unicode native était toujours utilisée si le terminal référencé par os peut afficher l'Unicode	seulement utilisée si le terminal ne peut utiliser que l'API Unicode native pour afficher l'Unicode

Voir aussi

vprint_nonunicode (std::ostream) (C++23)	affiche des données caractères en utilisant une représentation d'arguments à type effacé (fonction)
print (std::ostream) (C++23)	affiche la représentation formatée des arguments (modèle de fonction)
operator<< (std::basic_ostream)	insère des données caractères ou insère dans un flux rvalue (modèle de fonction)
vprint_unicode vprint_unicode_buffered (C++23)	imprime vers stdout compatible Unicode ou un flux de fichier en utilisant une représentation d'arguments à type effacé (fonction)
format (C++20)	stocke la représentation formatée des arguments dans une nouvelle chaîne (modèle de fonction)

Liens externes

1.	Unicode — Wikipédia
2.	The Unicode Standard Version 14.0 — Core Specification