Namespaces
Variants

std:: vprint_nonunicode, std:: vprint_nonunicode_buffered

From cppreference.net
< cpp ‎ | io
C++
Input/output library
Print functions
Print functions
(C++23)
(C++23)
(C++23) (C++23)
vprint_nonunicode vprint_nonunicode_buffered
(C++23) (C++23)
Défini dans l'en-tête <print>
void vprint_nonunicode ( std:: FILE * stream,
std:: string_view fmt, std:: format_args args ) ;
(1) (depuis C++23)
void vprint_nonunicode_buffered
( std:: FILE * stream, std:: string_view fmt, std:: format_args args ) ;
(2) (depuis C++23)
void vprint_nonunicode_buffered
( std:: string_view fmt, std:: format_args args ) ;
(3) (depuis C++23)

Formate args selon la chaîne de format fmt , et écrit le résultat dans le flux de sortie.

1) Tout en maintenant le verrou sur stream , écrit la représentation caractère des arguments de formatage fournis par args formatés selon les spécifications données dans fmt vers stream .
Si stream n'est pas un pointeur valide vers un flux de sortie C, le comportement est indéfini.
2) Équivalent à std:: string out = std:: vformat ( fmt, args ) ;
std :: vprint_nonunicode ( stream, "{}" , std:: make_format_args ( out ) ) ; .
3) Équivalent à std :: vprint_nonunicode_buffered ( stdout , fmt, args ) .


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

(since C++26)

Table des matières

Paramètres

stream - flux de fichier de sortie vers lequel écrire
fmt -
un objet qui représente la chaîne de format. La chaîne de format est composé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 } .

(depuis C++23)
(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

Notes

Macro de test de fonctionnalité Valeur Std Fonctionnalité
__cpp_lib_print 202207L (C++23) Sortie formatée
202403L (C++26)
(DR23) 		Sortie formatée non tamponnée
202406L (C++26)
(DR23) 		Activation de la sortie formatée non tamponnée pour plus de types formatables
__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
P3107R5 C++23 les opérations d'impression étaient toujours mises en mémoire tampon fournit des opérations d'impression sans mémoire tampon
P3235R3 C++23 les noms des fonctions ajoutées
par P3107R5 étaient trompeurs 		a modifié les noms des fonctions

Voir aussi

(C++23)
imprime vers une sortie stdout compatible Unicode ou un flux de fichier en utilisant une représentation type-erased des arguments
(fonction)
(C++23)
sort des données caractères en utilisant une représentation type-erased des arguments
(fonction)
(C++23)
imprime vers stdout ou un flux de fichier en utilisant la représentation formatée des arguments
(modèle de fonction)
(C++20)
stocke la représentation formatée des arguments dans une nouvelle chaîne
(modèle de fonction)