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

Revision as of 01:54, 14 November 2023

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)	Formatted output
`__cpp_lib_format`	202207L	(C++23)	Exposing std::basic_format_string

@@ Line 13: / Line 13: @@
 {{dcl end}}
-Format {{tt|args}} according to the format string {{tt|fmt}}, and writes the result to the stream.
+Format {{c|args}} according to the format string {{c|fmt}}, and writes the result to the stream.
 @1@ Writes the result of {{c|std::vformat(fmt, args)}} to the stream.
@@ Line 19: / Line 19: @@
 @2@ same as {{v|1}} when {{c|stream}} is equal to the standard C output stream {{lc|stdout}}, i.e.
-{{source|std::vprint_nonunicode(stdout, fmt, args);}}
+{{c|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]