$range (agregación)

Definición

$range

Devuelve una matriz cuyos elementos son una secuencia generada de números. $range genera la secuencia a partir del número inicial especificado incrementando sucesivamente el número inicial mediante el valor de paso especificado hasta el punto final, pero sin incluirlo.

$range tiene lo siguiente Sintaxis de expresión del operador:

{ $range: [ <start>, <end>, <non-zero step> ] }

Operando	Descripción
`<start>`	Un entero que especifica el inicio de la secuencia. Puede ser cualquier expresión válida que se resuelva en un entero.
`<end>`	Un entero que especifica el límite superior exclusivo de la secuencia. Puede ser cualquier expresión válida que se resuelva en un entero.
`<non-zero step>`	Opcional. Un entero que especifica el valor de incremento. Puede ser cualquier expresión válida que se resuelva en un entero distinto de cero. El valor predeterminado 1 es.

Comportamiento

Los argumentos <start> y <end> son obligatorios y deben ser números enteros. El argumento <non-zero step> es opcional y, si se omite, su valor predeterminado es 1.

Ejemplo	Resultados
`{ $range: [ 0, 10, 2 ] }`	`[ 0, 2, 4, 6, 8 ]`
`{ $range: [ 10, 0, -2 ] }`	`[ 10, 8, 6, 4, 2 ]`
`{ $range: [ 0, 10, -2 ] }`	`[ ]`
`{ $range: [ 0, 5 ] }`	`[ 0, 1, 2, 3, 4 ]`

Ejemplo

El siguiente ejemplo utiliza una colección llamada distances que enumera ciudades junto con su distancia en millas desde San Francisco.

Documentos en la colección distances:

db.distances.insertMany([
   { _id: 0, city: "San Jose", distance: 42 },
   { _id: 1, city: "Sacramento", distance: 88 },
   { _id: 2, city: "Reno", distance: 218 },
   { _id: 3, city: "Los Angeles", distance: 383 }
]);

Un ciclista planea viajar desde San Francisco a cada ciudad de la colección y desea parar a descansar cada 25 millas. La siguiente operación de agregación utiliza el operador $range para determinar los puntos de parada de cada viaje.

db.distances.aggregate([{
    $project: {
        _id: 0,
        city: 1,
        "Rest stops": { $range: [ 0, "$distance", 25 ] }
    }
}])

La operación devuelve lo siguiente:

{ "city" : "San Jose", "Rest stops" : [ 0, 25 ] }
{ "city" : "Sacramento", "Rest stops" : [ 0, 25, 50, 75 ] }
{ "city" : "Reno", "Rest stops" : [ 0, 25, 50, 75, 100, 125, 150, 175, 200 ] }
{ "city" : "Los Angeles", "Rest stops" : [ 0, 25, 50, 75, 100, 125, 150, 175, 200, 225, 250, 275, 300, 325, 350, 375 ] }

Volver

$rand

$rank