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.

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

L'`$strLenBytes`opérateur dans Amazon DocumentDB est utilisé pour déterminer la longueur d'une chaîne en octets. Cela est utile lorsque vous devez comprendre la taille de stockage d'un champ de chaîne, en particulier lorsqu'il s'agit de caractères Unicode qui peuvent utiliser plus d'un octet par caractère.

**Paramètres**
+ `expression`: expression de chaîne dont la longueur est calculée.

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

Cet exemple montre comment utiliser l'`$strLenBytes`opérateur pour calculer la longueur des champs de chaîne en octets.

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

```
db.people.insertMany([
  { "_id": 1, "Desk": "Düsseldorf-BVV-021" },
  { "_id": 2, "Desk": "Munich-HGG-32a" },
  { "_id": 3, "Desk": "Cologne-ayu-892.50" },
  { "_id": 4, "Desk": "Dortmund-Hop-78" }
]);
```

**Exemple de requête**

```
db.people.aggregate([
  {
    $project: {
      "Desk": 1,
      "length": { $strLenBytes: "$Desk" }
    }
  }
])
```

**Sortie**

```
{ "_id" : 1, "Desk" : "Düsseldorf-BVV-021", "length" : 19 }
{ "_id" : 2, "Desk" : "Munich-HGG-32a", "length" : 14 }
{ "_id" : 3, "Desk" : "Cologne-ayu-892.50", "length" : 18 }
{ "_id" : 4, "Desk" : "Dortmund-Hop-78", "length" : 15 }
```

Notez que la longueur de la chaîne « Düsseldorf-BVV-021 » est de 19 octets, ce qui est différent du nombre de points de code (18) en raison du caractère Unicode « Ü » occupant 2 octets.

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

Pour afficher un exemple de code relatif à l'utilisation de la `$strLenBytes` 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: {
        "Desk": 1,
        "length": { $strLenBytes: "$Desk" }
      }
    }
  ]).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': {
                "Desk": 1,
                "length": { "$strLenBytes": "$Desk" }
            }
        }
    ]))

    print(result)
    client.close()

example()
```

------