std::vformat
Defined in header <format> |
||
---|---|---|
std::string vformat(std::string_view fmt, std::format_args args); |
(1) | (since C++20) |
std::wstring vformat(std::wstring_view fmt, std::wformat_args args); |
(2) | (since C++20) |
std::string vformat(const std::locale& loc, std::string_view fmt, std::format_args args); |
(3) | (since C++20) |
std::wstring vformat(const std::locale& loc, std::wstring_view fmt, std::wformat_args args); |
(4) | (since C++20) |
Format arguments held by args
according to the format string fmt
, and return the result as a string. If present, loc
is used for locale-specific formatting.
Parameters
fmt | - | string view representing the format string. The format string consists of
Each replacement field has the following format:
|
||||||||||||
args | - | arguments to be formatted | ||||||||||||
loc | - | std::locale used for locale-specific formatting |
Return value
A string object holding the formatted result.
Exceptions
Throws std::format_error
if fmt
is not a valid format string for the provided arguments, or std::bad_alloc
on allocation failure. Also propagates any exception thrown by formatter or iterator operations.
Example
See also
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/utility/format/vformat