Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# $ Binärgröße
<a name="binarySize"></a>

Neu ab Version 8.0.1.

Der `$binarySize` Operator in Amazon DocumentDB gibt die Größe einer bestimmten Zeichenfolge oder eines binären Datenwerts in Byte zurück. Bei Zeichenfolgenwerten ist dies die Anzahl der UTF-8 kodierten Byte, nicht die Anzahl der Zeichen. Multi-byte UTF-8 Zeichen (wie Zeichen mit Akzenten oder CJK-Zeichen) ergeben eine Byteanzahl, die größer ist als die Anzahl der Zeichen in der Zeichenfolge.

**Parameter**
+ `expression`: Ein Ausdruck, der in eine Zeichenfolge oder einen binären Datenwert aufgelöst wird.

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

Das folgende Beispiel zeigt, wie der `$binarySize` Operator verwendet wird, um die Bytegröße von Zeichenfolgenfeldern zurückzugeben.

**Erstellen Sie Beispieldokumente **

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

**Beispiel für eine Abfrage **

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

**Ausgabe**

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

## Codebeispiele
<a name="binarySize-code"></a>

Um ein Codebeispiel für die Verwendung des `$binarySize` Operators anzuzeigen, wählen Sie die Registerkarte für die Sprache, die Sie verwenden möchten:

------
#### [ 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()
```

------