CKTIS / C++
std::format: типизирано форматиране в нов низ
std::format създава нов std::string от проверен форматен шаблон и неговите аргументи.
Версия: C++23
Синтаксис
template<class... Args>
std::string std::format(std::format_string<Args...> fmt, Args&&... args);
template<class... Args>
std::wstring std::format(std::wformat_string<Args...> fmt, Args&&... args);
template<class... Args>
std::string std::format(const std::locale& loc,
std::format_string<Args...> fmt, Args&&... args);
template<class... Args>
std::wstring std::format(const std::locale& loc,
std::wformat_string<Args...> fmt, Args&&... args);std::format(fmt, args...) от <format> връща нов std::string с представянията на аргументите в заместващи полета; широко-знаковият вариант връща std::wstring, а отделни претоварвания приемат std::locale. В C++23 обикновено извикване използва format_string<Args...>, чийто литерал се проверява при компилация спрямо броя и типовете на аргументите.
Примерът форматира 7 като 0007, 3.5 с две дробни цифри и удвоени фигурни скоби като буквален текст, извеждайки 0007 3.50 {ok}. {} избира следващия аргумент, а частта след : управлява подравняване, ширина, точност и вид на представяне. std::format връща отделен низ; std::format_to записва чрез изходен итератор.
Буквалните скоби се пишат като {{ и }}; автоматичното {} и ръчното {0} номериране не могат да се смесват. Невалиден литерал или несъвместим с типа спецификатор обикновено прави извикването некоректно още при компилация. За шаблон, известен едва по време на изпълнение, използвайте std::vformat. И std::format може да хвърли std::format_error за грешка, зависеща от стойност и открита при изпълнение, например невалидна динамична ширина или точност; изключенията от операциите на formatter се разпространяват, а алокацията може да хвърли std::bad_alloc. Собствен тип изисква валидна специализация на std::formatter; регионалното форматиране използва претоварването със std::locale и подходящи опции.
Примери
#include <format>
#include <iostream>
int main() {
std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}
Резултат
0007 3.50 {ok}std::format → 0007 3.50 {ok}