Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti