

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.

# $ est un numéro
<a name="isNumber"></a>

Nouveau depuis la version 8.0.1.

L'`$isNumber`opérateur d'Amazon DocumentDB renvoie une valeur booléenne indiquant si une expression donnée est de type numérique (entier, décimal, double, long). Notez que les tableaux ne sont pas considérés comme numériques, même si tous les éléments du tableau sont des nombres. Par exemple, `$isNumber` appliqué aux `[1, 2, 3]` retours de valeur`false`.

**Paramètres**
+ `expression`: toute expression permettant de vérifier si elle se résout en un type numérique.

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

L'exemple suivant montre comment utiliser l'`$isNumber`opérateur pour vérifier si les valeurs des champs sont numériques.

**Créez des exemples de documents **

```
db.data.insertMany([
  {_id: 1, value: 42},
  {_id: 2, value: "hello"},
  {_id: 3, value: 3.14},
  {_id: 4, value: null}
]);
```

**Exemple de requête **

```
db.data.aggregate([
  { $project: { isNum: { $isNumber: "$value" } } }
]);
```

**Sortie**

```
[
  {_id: 1, isNum: true},
  {_id: 2, isNum: false},
  {_id: 3, isNum: true},
  {_id: 4, isNum: false}
]
```

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

Pour afficher un exemple de code d'utilisation de l'`$isNumber`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('data');
    const result = await collection.aggregate([
      { $project: { isNum: { $isNumber: "$value" } } }
    ]).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['data']
        result = list(collection.aggregate([
            {'$project': {'isNum': {'$isNumber': '$value'}}}
        ]))
        print(result)
    finally:
        client.close()

example()
```

------