std::formatted_size
定义于头文件 <format>
|
||
template<class... Args> std::size_t formatted_size(std::string_view fmt, const Args&... args); |
(1) | (C++20 起) |
template<class... Args> std::size_t formatted_size(std::wstring_view fmt, const Args&... args); |
(2) | (C++20 起) |
template<class... Args> std::size_t formatted_size(const std::locale& loc, std::string_view fmt, const Args&... args); |
(3) | (C++20 起) |
template<class... Args> std::size_t formatted_size(const std::locale& loc, std::wstring_view fmt, const Args&... args); |
(4) | (C++20 起) |
确定按照格式字符串 fmt
格式化 args
得到的有格式字符串的总字符数。 loc
若存在则用于本地环境特定的格式化。
若对 Args
中任何 Ti
, std::formatter<Ti, CharT> 不满足格式化器 (Formatter) 要求则行为未定义。
参数
fmt | - | 表示格式字符串的字符串视图。
每个替换域拥有下列格式:
arg-id 指定用于格式化其值的 格式说明由对应参数特化的 std::formatter 定义。
|
args... | - | 要格式化的参数 |
loc | - | 用于本地环境特定的格式化的 std::locale |
返回值
有格式字符串中的总字符数。
异常
若 fmt
对于提供的参数不是合法的格式字符串则抛出 std::format_error 。并且会传播格式化器所抛的任何异常。
示例
运行此代码
#include <format> #include <iostream> #include <vector> #include <string_view> int main() { using namespace std::literals::string_view_literals; constexpr auto fmt_str { "Hubble's H{0} {1} {2:*^4} miles/sec/mpc."sv }; constexpr auto sub_zero { "₀"sv }; // { "\u2080"sv } => { 0xe2, 0x82, 0x80 }; constexpr auto aprox_equ { "≅"sv }; // { "\u2245"sv } => { 0xe2, 0x89, 0x85 }; constexpr int Ho { 42 }; // H₀ const auto min_buffer_size = std::formatted_size(fmt_str, sub_zero, aprox_equ, Ho); std::cout << "Min buffer size = " << min_buffer_size << '\n'; // 以 std::vector 为动态缓冲区。注:缓冲区不包含尾随 '\0' 。 std::vector<char> buffer(min_buffer_size); std::format_to_n(buffer.data(), buffer.size(), fmt_str, sub_zero, aprox_equ, Ho); std::cout << "Buffer: \"" << std::string_view{buffer.data(), min_buffer_size} << "\"\n"; // 或者我们能通过添加尾随 '\0' 直接打印缓冲区。 buffer.push_back('\0'); std::cout << "Buffer: \"" << buffer.data() << "\"\n"; }
输出:
Min buffer size = 37 Buffer: "Hubble's H₀ ≅ *42* miles/sec/mpc." Buffer: "Hubble's H₀ ≅ *42* miles/sec/mpc."