CKTIS / C++
std::vformat — formattazione con una stringa di formato determinata a runtime
std::vformat di <format> crea una stringa a partire da una stringa di formato e da un pacchetto di argomenti std::format_args. Accetta un modello determinato a runtime e segnala con std::format_error i formati non validi per gli argomenti forniti.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <format>
std::string std::vformat(std::string_view fmt, std::format_args args);
std::wstring std::vformat(std::wstring_view fmt, std::wformat_args args);
std::string std::vformat(const std::locale& loc, std::string_view fmt, std::format_args args);
std::wstring std::vformat(const std::locale& loc, std::wstring_view fmt, std::wformat_args args);std::vformat restituisce una nuova stringa invece di scrivere su uno stream. Accetta una stringa di formato e un pacchetto di argomenti con i tipi cancellati. L’overload con std::string_view restituisce std::string; quello con std::wstring_view usa std::wformat_args e restituisce std::wstring. Gli overload che accettano std::locale supportano la formattazione dipendente dalle impostazioni locali.
In C++23, std::format normalmente controlla la stringa di formato in fase di compilazione. std::vformat, invece, accetta un modello disponibile solo a runtime. Una sintassi non valida, un argomento referenziato mancante o uno specificatore incompatibile con il tipo dell’argomento causano std::format_error. Dalla chiamata possono inoltre propagarsi eccezioni dei formatter ed errori di allocazione.
Crea il pacchetto con std::make_format_args usando variabili con nome. Non considerarlo proprietario di tutti i valori: può conservare riferimenti ai dati degli argomenti. Questi dati devono restare validi fino al termine della formattazione e std::format_args da solo non prolunga la durata dell’archiviazione creata da std::make_format_args. Passare tale archiviazione direttamente alla chiamata, come nell’esempio, evita che venga distrutta troppo presto.
Nell’esempio, {} inserisce label, mentre {:04d} scrive count in decimale con una larghezza minima di quattro caratteri e zeri iniziali. L’output è item: 0007, seguito da un carattere di nuova riga. Questa voce riguarda C++23; il riferimento fornito rimanda a una bozza di lavoro in evoluzione che può includere modifiche successive. Un’opzione del compilatore nel repository non dimostra che la libreria sia disponibile nell’ambiente di produzione.
Esempi
#include <format>
#include <iostream>
#include <string>
int main() {
std::string pattern = "{}: {:04d}";
std::string label = "item";
int count = 7;
std::string result = std::vformat(
pattern, std::make_format_args(label, count));
std::cout << result << '\n';
}
Risultato
item: 0007
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.