std:: vprint_nonunicode, std:: vprint_nonunicode_buffered

From cppreference.com

Defined in header `<print>`
void vprint_nonunicode ( std:: FILE * stream, std:: string_view fmt, std:: format_args args ) ;	(1)	(since C++23)
void vprint_nonunicode_buffered ( std:: FILE * stream, std:: string_view fmt, std:: format_args args ) ;	(2)	(since C++23)
void vprint_nonunicode_buffered ( std:: string_view fmt, std:: format_args args ) ;	(3)	(since C++23)

Format args according to the format string fmt , and writes the result to the output stream.

1) While holding the lock on stream , writes the character representation of formatting arguments provided by args formatted according to specifications given in fmt to stream .

If stream is not a valid pointer to an output C stream, the behavior is undefined.

2) Equivalent to: std:: string out = std:: vformat ( fmt, args ) ;
std :: vprint_nonunicode ( stream, "{}" , std:: make_format_args ( out ) ) ;

3) Equivalent to: std :: vprint_nonunicode_buffered ( stdout , fmt, args ) .

Parameters

stream - output file stream to write to

fmt

an object that represents the format string. The format string consists of

ordinary characters (except { and } ), which are copied unchanged to the output,
escape sequences { { and } } , which are replaced with { and } respectively in the output, and
replacement fields.

Each replacement field has the following format:


`{` arg-id (optional) `}`	(1)

`{` arg-id (optional) `:` format-spec `}`	(2)

1) replacement field without a format specification

2) replacement field with a format specification

arg-id	-	specifies the index of the argument in `args` whose value is to be used for formatting; if it is omitted, the arguments are used in order. The arg-id s in a format string must all be present or all be omitted. Mixing manual and automatic indexing is an error.
format-spec	-	the format specification defined by the std::formatter specialization for the corresponding argument. Cannot start with } .

For basic types and standard string types, the format specification is interpreted as standard format specification .
For chrono types, the format specification is interpreted as chrono format specification .

For range types, the format specification is interpreted as range format specification .
For std::pair and std::tuple , the format specification is interpreted as tuple format specification .
For std::thread::id and std::stacktrace_entry , see thread id format specification and stacktrace entry format specification .
For std::basic_stacktrace , no format specifier is allowed.

(since C++23)

For std::filesystem::path , see path format specification .

(since C++26)

For other formattable types, the format specification is determined by user-defined formatter specializations.

args - arguments to be formatted

Exceptions

std::bad_alloc on allocation failure.
std::system_error , if writing to the stream fails.
Propagates any exception thrown by used formatters , e.g. std::format_error .

Notes

Feature-test macro	Value	Std	Feature
`__cpp_lib_print`	202207L	(C++23)	Formatted output
	202403L	(C++26) (DR23)	Formatted output with stream locking
	202406L	(C++26) (DR23)	Enabling nonlocking formatter optimization for more formattable types
`__cpp_lib_format`	202207L	(C++23)	Exposing std::basic_format_string

Example

This section is incomplete
Reason: no example

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Metaprogramming library (C++11)
Diagnostics library
General utilities library
Strings library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Numerics library
Localizations library
Input/output library
Filesystem library (C++17)
Regular expressions library (C++11)
Concurrency support library (C++11)
Execution support library (C++26)
Technical specifications
Symbols index
External libraries

I/O manipulators
Print functions (C++23)
C-style I/O
Buffers
basic_streambuf
basic_filebuf
basic_stringbuf
basic_spanbuf (C++23)
strstreambuf ( C++98/26* )
basic_syncbuf (C++20)
Streams
Abstractions
ios_base
basic_ios
basic_istream
basic_ostream
basic_iostream
File I/O
basic_ifstream
basic_ofstream
basic_fstream
String I/O
basic_istringstream
basic_ostringstream
basic_stringstream
Array I/O
basic_ispanstream (C++23)
basic_ospanstream (C++23)
basic_spanstream (C++23)
istrstream ( C++98/26* )
ostrstream ( C++98/26* )
strstream ( C++98/26* )
Synchronized Output
basic_osyncstream (C++20)
Types
streamoff
streamsize
fpos
Error category interface
iostream_category (C++11)
io_errc (C++11)

Print functions
print (C++23)
println (C++23)
vprint_unicode vprint_unicode_buffered (C++23) (C++23)
vprint_nonunicode vprint_nonunicode_buffered (C++23) (C++23)

vprint_unicode vprint_unicode_buffered (C++23)	prints to Unicode capable stdout or a file stream using type-erased argument representation (function)
vprint_nonunicode (std::ostream) (C++23)	outputs character data using type-erased argument representation (function)
print (C++23)	prints to stdout or a file stream using formatted representation of the arguments (function template)
format (C++20)	stores formatted representation of the arguments in a new string (function template)

std:: vprint_nonunicode, std:: vprint_nonunicode_buffered

Parameters

Exceptions

Notes

Example

See also

Navigation