Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# \$1mod
<a name="mod-query"></a>

El operador de `$mod` consulta selecciona los documentos en los que un valor de campo dividido por un divisor tiene un resto especificado. Esto resulta útil para filtrar documentos en función de las condiciones aritméticas de los módulos.

**Parámetros**
+ `divisor`: el número por el que se va a dividir.
+ `remainder`: El valor restante esperado.

## Ejemplo (MongoDB Shell)
<a name="mod-query-examples"></a>

En el siguiente ejemplo, se muestra el uso del `$mod` operador para buscar todos los pedidos en los que la cantidad es un número impar.

**Cree documentos de muestra**

```
db.orders.insertMany([
  { _id: 1, item: "Widget", quantity: 15 },
  { _id: 2, item: "Gadget", quantity: 20 },
  { _id: 3, item: "Tool", quantity: 7 },
  { _id: 4, item: "Device", quantity: 12 },
  { _id: 5, item: "Part", quantity: 9 }
]);
```

**Ejemplo de consulta**

```
db.orders.find({ quantity: { $mod: [2, 1] } });
```

**Salida**

```
{ "_id" : 1, "item" : "Widget", "quantity" : 15 }
{ "_id" : 3, "item" : "Tool", "quantity" : 7 }
{ "_id" : 5, "item" : "Part", "quantity" : 9 }
```

Esta consulta devuelve documentos en los que la cantidad dividida por 2 tiene un resto igual a 1, lo que permite seleccionar todas las cantidades impares.

## Ejemplos de código
<a name="mod-query-code"></a>

Para ver un ejemplo de código para usar el operador de `$mod` consulta, elija la pestaña correspondiente al idioma que desee usar:

------
#### [ 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('orders');

  const result = await collection.find({ quantity: { $mod: [2, 1] } }).toArray();

  console.log(JSON.stringify(result, null, 2));
  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['orders']

    result = list(collection.find({'quantity': {'$mod': [2, 1]}}))

    print(result)
    client.close()

example()
```

------