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}