CKTIS / C++
std::vformat — formater avec une chaîne de format déterminée à l’exécution
std::vformat de <format> construit une chaîne à partir d’une chaîne de format et d’un paquet d’arguments std::format_args. Il accepte un motif déterminé à l’exécution et signale les formats invalides pour les arguments fournis au moyen de std::format_error.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#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 renvoie une nouvelle chaîne au lieu d’écrire dans un flux. Il accepte une chaîne de format et un paquet d’arguments dont les types sont effacés. La surcharge avec std::string_view renvoie un std::string ; celle avec std::wstring_view utilise std::wformat_args et renvoie un std::wstring. Les surcharges prenant un std::locale prennent en charge le formatage dépendant des paramètres régionaux.
En C++23, std::format vérifie normalement sa chaîne de format à la compilation. À l’inverse, std::vformat accepte un motif disponible uniquement à l’exécution. Une syntaxe invalide, un argument référencé manquant ou un spécificateur incompatible avec le type de l’argument provoque std::format_error. Des exceptions provenant des formateurs et des échecs d’allocation peuvent également remonter de l’appel.
Construisez le paquet avec std::make_format_args à partir de variables nommées. Ne le considérez pas comme propriétaire de toutes les valeurs : il peut conserver des références aux données des arguments. Ces données doivent rester valides jusqu’à la fin du formatage, et std::format_args ne prolonge pas à lui seul la durée de vie du stockage créé par std::make_format_args. Transmettre ce stockage directement à l’appel, comme dans l’exemple, évite sa destruction prématurée.
Dans l’exemple, {} insère label, tandis que {:04d} écrit count en décimal avec une largeur minimale de quatre caractères et des zéros en tête. La sortie est item: 0007, suivie d’un saut de ligne. Cette entrée concerne C++23 ; la référence fournie pointe vers un projet de norme en évolution susceptible de contenir des changements ultérieurs. Un indicateur de compilateur dans un dépôt ne prouve pas que la bibliothèque est disponible dans l’environnement de production.
Exemples
#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';
}
Résultat
item: 0007
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.