std::vformat
From cppreference.com
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
Parameters
| 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 | ||||||||||||||||||||||||||||||||||||||||||||||
| 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
Example
Run this code
#include <format> #include <iostream> template<typename... Args> inline void println(const std::format_string<Args...> fmt, Args&&... args) { std::cout << std::vformat(fmt.get(), std::make_format_args(args...)) << '\n'; } int main() { println("{}{} {}{}", "Hello", ',', "C++", -1 + 2 * 3 * 4); }
Output:
Hello, C++23