База знанияИзпитен център
BGБългарски
Избери език13

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}

Източници