format |
Format |
|---|---|
| Rust | |
Syntaxe
|
macro_rules! format { ($($arg:tt)*) => { ... }; } |
Description
Cette macro permet de créer une String formatée à partir d'expressions d'exécution, en utilisant une syntaxe d'interpolation.
Remarques
Crée une chaîne par interpolation d'expressions d'exécution.
Le premier argument reçu par format! est une chaîne de format. Il doit s'agir d'une chaîne littérale. La puissance de la chaîne de formatage réside dans les {} qu'elle contient. Les paramètres supplémentaires passés à format! remplacent les {} de la chaîne de formatage dans l'ordre indiqué, sauf si des paramètres nommés ou positionnels sont utilisés.
Format! est couramment utilisé pour la concaténation et l'interpolation de chaînes. La même convention est utilisée avec les macros print! et write!, selon la destination de la chaîne ; toutes ces macros utilisent en interne format_args!.
Pour convertir une valeur unique en chaîne, utilisez la méthode to_string. Cette méthode utilise le trait de formatage Display.
Pour concaténer des littéraux dans une chaîne statique, utilisez la macro concat!.
Paniques
format! panique si une implémentation du trait de formatage renvoie une erreur. Cela indique une implémentation incorrecte, car fmt::Write pour String ne renvoie jamais d'erreur.
Exemples
- format!("test"); // => "test"
- format!("bonjour {}", "le monde!"); // => "bonjour le monde!"
- format!("x = {}, y = {val}", 10, val = 30); // => "x = 10, y = 30"
- let (x, y) = (1, 2);
- format!("{x} + {y} = 3"); // => "1 + 2 = 3"