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.

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

Nouveau depuis la version 4.0

L'`$trim`opérateur d'Amazon DocumentDB est utilisé pour supprimer les espaces blancs and/or de fin d'une chaîne.

**Paramètres**
+ `input`: expression de chaîne à découper.
+ `chars`: (facultatif) Spécifie les caractères à découper à partir du début et de la fin de la saisie. La valeur par défaut est un espace.

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

L'exemple suivant montre comment utiliser l'`$trim`opérateur pour supprimer les espaces de début et de fin d'une chaîne.

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

```
db.people.insertMany([
  { "name": "   John Doe   " },
  { "name": "   Bob Johnson   " }
])
```

**Exemple de requête**

```
db.people.aggregate([
  { $project: {
    "name": { $trim: {input: "$name"}}
  }}
])
```

**Sortie**

```
[
  { "name": "John Doe" },
  { "name": "Bob Johnson" }
]
```

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

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

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

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

async function example() {
  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('people');

  const result = await collection.aggregate([
    { $project: {
      "name": { $trim: {input: "$name" }}
    }}
  ]).toArray();

  console.log(result);
  client.close();
}

example();
```

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

```
from pymongo import MongoClient

def example():
    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['people']

    result = list(collection.aggregate([
        {"$project": {
            "name": {"$trim": {"input": "$name"}}
        }}
    ]))

    print(result)
    client.close()

example()
```

------