| Defined in header <ostream>
|
||
| void vprint_nonunicode( std::ostream& os, std::string_view fmt, std::format_args args ); |
(since C++23) | |
Behaves as FormattedOutputFunction (except that some details of error reporting differ):
- First, constructs and checks the sentry object.
- Then, initializes an automatic variable as if by
std::string out = std::vformat(os.getloc(), fmt, args);. - Finally, inserts the character sequence
[out.begin(), out.end())intoos.
Parameters
| os | - | output stream to insert data into | ||||||||||||||||||||||||||||||||||||||||||||||
| fmt | - | an object that represents the format string. The format string consists of
Each replacement field has the following format:
1) replacement field without a format specification
2) replacement field with a format specification
| ||||||||||||||||||||||||||||||||||||||||||||||
| args | - | arguments to be formatted | ||||||||||||||||||||||||||||||||||||||||||||||
Return value
(none)
Exceptions
- std::bad_alloc on allocation failure.
- Propagate any exception thrown by any formatter, e.g. std::format_error, without regard to the value of
os.exceptions()and without turning on ios_base::badbit in the error state ofos. - May throw ios_base::failure caused by
os.setstate(ios_base::badbit)which is called if an insertion intoosfails.
Notes
| 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 |
Example
This section is incomplete
Reason: no example
Reason: no example
See also
| (C++23) |
performs Unicode aware output using type-erased argument representation (function) |
| (C++23) |
outputs formatted representation of the arguments (function template) |
| inserts character data or insert into rvalue stream (function template) | |
| prints to stdout or a file stream using type-erased argument representation (function) | |
| (C++20) |
stores formatted representation of the arguments in a new string (function template) |
Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.