Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# \$1regex
<a name="regex"></a>

L'`$regex`opérateur vous permet d'effectuer une correspondance d'expressions régulières sur des champs de chaîne. Il s'agit d'un outil puissant pour rechercher et filtrer des documents en fonction de modèles complexes.

**Paramètres**
+ `regular expression`: le modèle d'expression régulière à associer au champ.
+ `$options`: (facultatif) Fournit des options permettant de modifier le comportement de recherche, telles que la distinction majuscules/minuscules, la correspondance globale, etc.

## Exemple (MongoDB Shell)
<a name="regex-examples"></a>

L'exemple suivant illustre l'utilisation de l'`$regex`opérateur pour rechercher des documents dont le champ « nom » correspond à un modèle spécifique.

**Création d'exemples de documents**

```
db.users.insertMany([
  { name: "John Doe" },
  { name: "Jane Smith" },
  { name: "Alice Johnson" },
  { name: "Bob Williams" },
  { name: "Charlie Davis" }
]);
```

**Exemple de requête**

```
db.users.find({ name: { $regex: /^A/ } })
```

**Sortie**

```
[
  { "_id" : ObjectId("..."), "name" : "Alice Johnson" }
]
```

Cette requête renverra tous les documents dont le champ « nom » commence par la lettre « A ».

## Exemples de code
<a name="regex-code"></a>

Pour afficher un exemple de code relatif à l'utilisation de la `$regex` commande, choisissez l'onglet correspondant à la langue que vous souhaitez utiliser :

------
#### [ Node.js ]

```
const { MongoClient } = require('mongodb');

async function main() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('users');

  const results = await collection.find({ name: { $regex: /^A/ } }).toArray();
  console.log(results);

  await client.close();
}

main();
```

------
#### [ Python ]

```
from pymongo import MongoClient

def main():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    collection = db['users']

    results = list(collection.find({ 'name': { '$regex': '^A' } }))
    print(results)

    client.close()

if __name__ == "__main__":
    main()
```

------