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.

# Taille binaire $
<a name="binarySize"></a>

Nouveau depuis la version 8.0.1.

L'`$binarySize`opérateur dans Amazon DocumentDB renvoie la taille en octets d'une chaîne ou d'une valeur de données binaires donnée. Pour les valeurs de chaîne, il s'agit du nombre d'octets UTF-8 codés et non du nombre de caractères. Multi-byte UTF-8 les caractères (tels que les caractères accentués ou les caractères CJK) produiront un nombre d'octets supérieur au nombre de caractères de la chaîne.

**Paramètres**
+ `expression`: expression qui se résout en une chaîne ou une valeur de données binaire.

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

L'exemple suivant montre comment utiliser l'`$binarySize`opérateur pour renvoyer la taille en octets des champs de chaîne.

**Créez des exemples de documents **

```
db.docs.insertMany([
  {_id: 1, content: "hello"},
  {_id: 2, content: "Amazon DocumentDB"},
  {_id: 3, content: ""}
]);
```

**Exemple de requête **

```
db.docs.aggregate([
  { $project: { size: { $binarySize: "$content" } } }
]);
```

**Sortie**

```
[
  {_id: 1, size: 5},
  {_id: 2, size: 17},
  {_id: 3, size: 0}
]
```

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

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

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

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

async function example() {
  const client = new MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  try {
    await client.connect();
    const db = client.db('test');
    const collection = db.collection('docs');
    const result = await collection.aggregate([
      { $project: { size: { $binarySize: "$content" } } }
    ]).toArray();
    console.log(result);
  } finally {
    await 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')
    try:
        db = client['test']
        collection = db['docs']
        result = list(collection.aggregate([
            {'$project': {'size': {'$binarySize': '$content'}}}
        ]))
        print(result)
    finally:
        client.close()

example()
```

------