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.

# $count (accumulateur)
<a name="count-accumulator"></a>

Nouveau depuis la version 8.0.1.

Utilisez l'`$count`accumulateur au cours d'une `$group` étape pour renvoyer le nombre de documents de chaque groupe. Il accepte un objet vide `{}` comme argument.

Ceci est différent de l'étape du `$count` pipeline, qui est une étape autonome qui compte tous les documents transitant par le pipeline. L'`$count`accumulateur compte plutôt les documents de chaque groupe produits par`$group`.

**Syntaxe**

```
{ $count: {} }
```

**Paramètres**
+ L'`$count`accumulateur n'accepte aucun argument. Il accepte un objet vide `{}` et renvoie le nombre de documents dans chaque groupe.

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

L'exemple suivant montre comment utiliser l'`$count`accumulateur pour compter le nombre de produits dans chaque catégorie.

**Créez des exemples de documents **

```
db.products.insertMany([
  { name: "Widget", category: "A" },
  { name: "Gadget", category: "A" },
  { name: "Doohickey", category: "B" },
  { name: "Thingamajig", category: "B" },
  { name: "Whatsit", category: "B" }
])
```

**Exemple de requête **

```
db.products.aggregate([
  { $group: { _id: "$category", count: { $count: {} } } }
])
```

**Sortie**

```
[
  { "_id": "A", "count": 2 },
  { "_id": "B", "count": 3 }
]
```

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

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

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

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

async function example() {
  const uri = 'mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false';
  const client = new MongoClient(uri);

  try {
    await client.connect();

    const db = client.db('test');
    const collection = db.collection('products');

    const result = await collection.aggregate([
      { $group: { _id: "$category", count: { $count: {} } } }
    ]).toArray();

    console.log(result);

  } catch (error) {
    console.error('Error:', error);
  } finally {
    await client.close();
  }
}

example();
```

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

```
from pymongo import MongoClient
from pprint import pprint

def example():
    client = None
    try:
        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['products']

        result = list(collection.aggregate([
            { '$group': { '_id': '$category', 'count': { '$count': {} } } }
        ]))

        pprint(result)

    except Exception as e:
        print(f"An error occurred: {e}")

    finally:
        if client:
            client.close()

example()
```

------