Difference between revisions of "cpp/io/vprint nonunicode"

Revision as of 08:18, 5 September 2022

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( std::string_view fmt, std::format_args args );	(2)	(since C++23)

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

1) Writes the result of std::vformat(fmt, args) to the stream. The behavior is undefined if stream is not a valid pointer to a C stream.

2) same as (1) when stream is equal to the standard C output stream stdout, i.e.

std::vprint_nonunicode(stdout, fmt, args);

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.

(since C++23)

(since C++26)

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

args - arguments to be formatted

(none)

Feature-test macro	Value	Std	Feature
`__cpp_lib_print`	202207L	(C++23)
`__cpp_lib_format`	202207L	(C++23)

@@ Line 18: / Line 18: @@
 The behavior is undefined if {{c|stream}} is not a valid pointer to a C stream.
-@2@ same as {{v|1}} when {{c|stream}} is equal to the text stream {{lc|stdout}}, i.e.
+@2@ same as {{v|1}} when {{c|stream}} is equal to the standard C output stream {{lc|stdout}}, i.e.
-{{c|std::vprint_nonunicode(stdout, fmt, args);}}.
+{{source|std::vprint_nonunicode(stdout, fmt, args);}}
 ===Parameters===

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

Print functions
print (C++23)
println (C++23)
vprint_unicodevprint_unicode_buffered (C++23)(C++23)
vprint_nonunicodevprint_nonunicode_buffered (C++23)(C++23)

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