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.

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

Mit dem `$slice` Aggregationsoperator können Sie eine Teilmenge eines Arrays zurückgeben, indem Sie das Array entweder vom Anfang oder vom Ende des Arrays durchqueren. Dies wird verwendet, um eine begrenzte Anzahl von Elementen aus einem Array-Feld anzuzeigen, z. B. die obersten oder untersten N Elemente.

**Parameter**
+ `array`: Das Array-Feld, das aufgeteilt werden soll.
+ `n`: Eine Ganzzahl, die die Anzahl der zurückzugebenden Elemente angibt. Ein positiver Wert beginnt am Anfang des Arrays, während ein negativer Wert am Ende des Arrays beginnt.

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

Das folgende Beispiel zeigt, wie Sie `$slice` jedem Koch die ersten beiden Lieblingssüßigkeiten zurückgeben können.

**Erstellen Sie Beispieldokumente**

```
db.sweets.insertMany([
  { "_id" : 1, "name" : "Alvin", "favorites": [ "chocolate", "cake", "toffee", "beignets" ] },
  { "_id" : 2, "name" : "Tom", "favorites": [ "donuts", "pudding", "pie" ] },
  { "_id" : 3, "name" : "Jessica", "favorites": [ "fudge", "smores", "pudding", "cupcakes" ] },
  { "_id" : 4, "name" : "Rachel", "favorites": [ "ice cream" ] }
]);
```

**Beispiel für eine Abfrage**

```
db.sweets.aggregate([
  { $project: { _id: 0, name: 1, topTwoFavorites: { $slice: [ "$favorites", 2 ] } } }
]);
```

**Ausgabe**

```
[
  { name: 'Alvin', topTwoFavorites: [ 'chocolate', 'cake' ] },
  { name: 'Tom', topTwoFavorites: [ 'donuts', 'pudding' ] },
  { name: 'Jessica', topTwoFavorites: [ 'fudge', 'smores' ] },
  { name: 'Rachel', topTwoFavorites: [ 'ice cream' ] }
]
```

In diesem Beispiel wird der `$slice` Operator verwendet, um die ersten beiden Elemente aus dem `favorites` Array für jedes Dokument zu extrahieren.

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

Um ein Codebeispiel für die Verwendung des `$slice` Befehls 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 = 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('sweets');

  const result = await collection.aggregate([
    { $project: { name: 1, topTwoFavorites: { $slice: ['$favorites', 2] } } }
  ]).toArray();

  console.log(result);
  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')
    db = client['test']
    collection = db['sweets']

    result = list(collection.aggregate([
        { '$project': { 'name': 1, 'topTwoFavorites': { '$slice': ['$favorites', 2] } } }
    ]))

    print(result)
    client.close()

example()
```

------