Format arguments held by args according to the format string fmt, and write the result to the output iterator out. If present, loc is used for locale-specific formatting.
Let CharT
be decltype(fmt)::char_type (char for overloads (1,3), wchar_t for overloads (2,4)).
These overloads participate in overload resolution only if OutputIt
satisfies the concept std::output_iterator<const CharT&>.
OutputIt
must model (meet the semantic requirements of) the concept std::output_iterator<const CharT&>, and std::formatter<Ti, CharT> must meet the Formatter requirements for any Ti
in the type of arguments. Otherwise, the behavior is undefined.
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 inargs
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 }.formatter
specializations.Iterator past the end of the output range.
[edit] ExceptionsThrows std::format_error if fmt is not a valid format string for the provided arguments. Also propagates any exception thrown by formatter or iterator operations.
[edit] Example [edit] Defect reportsThe following behavior-changing defect reports were applied retroactively to previously published C++ standards.
DR Applied to Behavior as published Correct behavior P2216R3 C++20 type of args is parameterized onOutputIt
not parameterized [edit] See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4