Section courante

A propos

Section administrative du site

matches

 Correspondances
Rust

Syntaxe

macro_rules! matches {
   ($expression:expr, $pattern:pat $(if $guard:expr)? $(,)?) => { ... };
}

Description

Cette macro permet de tester si une expression correspond à un motif donné, retournant un booléen (true ou false).

Remarques

Permet d'indiquer si l'expression donnée correspond au modèle fourni.

La syntaxe du modèle est identique à celle d'un bras de correspondance. La protection optionnelle if peut être utilisée pour ajouter des vérifications supplémentaires qui doivent être vraies pour la valeur correspondante, sinon cette macro renvoie false.

Pour tester la correspondance d'une valeur avec un modèle, il est généralement préférable d'utiliser assert_matches!, car elle affichera la représentation de débogage de la valeur en cas d'échec de l'assertion.

Exemples

  1. let foo = 'f';
  2. assert!(matches!(foo, 'A'..='Z' | 'a'..='z'));
  3.  
  4. let bar = Some(4);
  5. assert!(matches!(bar, Some(x) if x > 2));

Dernière mise à jour : Mardi, le 5 Août 2025