std:: vprint_nonunicode (std::ostream)

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

Se comporte comme une FormattedOutputFunction (sauf que certains détails de la gestion des erreurs diffèrent ).

Effectue les opérations suivantes dans l'ordre :

1. D'abord, construit et vérifie l'objet sentry .
2. Ensuite, initialise une variable automatique comme si par std:: string out = std:: vformat ( os. getloc ( ) , fmt, args ) ; .
3. Finalement, insère la séquence de caractères [ out. begin ( ) , out. end ( ) ) dans os .

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

(since C++26)

Table des matières 1 Paramètres 2 Exceptions 3 Notes 4 Exemple 5 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

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

Voir aussi

vprint_unicode (std::ostream) (C++23)	effectue une sortie prenant en charge Unicode en utilisant une représentation d'arguments à type effacé (fonction)
print (std::ostream) (C++23)	produit une représentation formatée des arguments (modèle de fonction)
operator<< (std::basic_ostream)	insère des données caractère ou insère dans un flux rvalue (modèle de fonction)
vprint_nonunicode vprint_nonunicode_buffered (C++23)	imprime vers stdout 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)