Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::format: formattazione tipizzata in una nuova stringa

std::format crea un nuovo std::string da un modello verificato e dai suoi argomenti.

Versione: C++23

Sintassi

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...) di <format> restituisce un nuovo std::string con le rappresentazioni degli argomenti nei campi di sostituzione; la variante wide restituisce std::wstring e altri overload accettano std::locale. In C++23 una chiamata ordinaria usa format_string<Args...>, il cui letterale viene verificato in compilazione rispetto a numero e tipi degli argomenti.

L’esempio formatta 7 come 0007, 3.5 con due cifre frazionarie e le doppie graffe come testo letterale, stampando 0007 3.50 {ok}. {} seleziona l’argomento successivo, mentre la parte dopo : controlla allineamento, larghezza, precisione e tipo di presentazione. std::format restituisce una stringa separata; std::format_to scrive tramite un iteratore di output.

Le graffe letterali si scrivono {{ e }}; non si possono mescolare numerazione automatica {} e manuale {0}. Un letterale non valido o uno specificatore incompatibile rende normalmente la chiamata mal formata in compilazione. Per un modello noto solo a runtime usa std::vformat. Anche std::format può lanciare std::format_error per un errore dipendente dai valori rilevato a runtime, come larghezza o precisione dinamica non valida; le eccezioni delle operazioni del formatter si propagano e l’allocazione può lanciare std::bad_alloc. Un tipo utente richiede una specializzazione valida di std::formatter; il formato locale usa l’overload std::locale e opzioni appropriate.

Esempi

#include <format>
#include <iostream>

int main() {
    std::cout << std::format("{:04} {:.2f} {{ok}}", 7, 3.5) << '\n';
}

Risultato

0007 3.50 {ok}

std::format → 0007 3.50 {ok}

Fonti