$slice (agregación)

Definición

$slice

Novedad en la versión 3.2.

Devuelve un subconjunto de un arreglo.

$slice tiene una de dos formas sintácticas:

La siguiente sintaxis devuelve elementos ya sea desde el inicio o el final del arreglo:

{ $slice: [ <array>, <n> ] }

La siguiente sintaxis devuelve elementos de la posición especificada en el arreglo:

{ $slice: [ <array>, <position>, <n> ] }

Operando	Descripción
<array>	Any valid expresión siempre que se resuelva en una matriz.
<position>	Opcional. Cualquier expresión válida siempre que se resuelva en un entero. Si es positivo, $slice determina la posición inicial desde el comienzo del arreglo. Si <position> es mayor que el número de elementos, el $slice devuelve un arreglo vacío. Si es negativo, $slice determina la posición inicial desde el final del arreglo. Si el valor absoluto de <position> es mayor que el número de elementos, la posición inicial es el comienzo del arreglo.
<n>	Cualquier expresión válida siempre que se resuelva en un entero. Si <position> se especifica, <n> debe resolverse en un entero positivo. Si es positivo, $slice devuelve hasta los primeros n elementos del arreglo. Si se especifica el <position>, $slice devuelve los primeros n elementos a partir de la posición. Si es negativo, $slice devuelve hasta los últimos n elementos del arreglo. n no puede resolverse a un número negativo si <position> está especificado.

Para obtener más información sobre las expresiones, consulta Expresiones.

Comportamiento

{ $slice: [ [ 1, 2, 3 ], 1, 1 ] }

[ 2 ]

{ $slice: [ [ 1, 2, 3 ], -2 ] }

[ 2, 3 ]

{ $slice: [ [ 1, 2, 3 ], 15, 2 ] }

[  ]

{ $slice: [ [ 1, 2, 3 ], -15, 2 ] }

[ 1, 2 ]

Ejemplo

Una colección llamada users contiene los siguientes documentos:

{ "_id" : 1, "name" : "dave123", favorites: [ "chocolate", "cake", "butter", "apples" ] }
{ "_id" : 2, "name" : "li", favorites: [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", favorites: [ "pears", "pecans", "chocolate", "cherries" ] }
{ "_id" : 4, "name" : "ty", favorites: [ "ice cream" ] }

El siguiente ejemplo devuelve como máximo los primeros tres elementos del arreglo favorites para cada usuario:

db.users.aggregate([
   { $project: { name: 1, threeFavorites: { $slice: [ "$favorites", 3 ] } } }
])

La operación devuelve los siguientes resultados:

{ "_id" : 1, "name" : "dave123", "threeFavorites" : [ "chocolate", "cake", "butter" ] }
{ "_id" : 2, "name" : "li", "threeFavorites" : [ "apples", "pudding", "pie" ] }
{ "_id" : 3, "name" : "ahn", "threeFavorites" : [ "pears", "pecans", "chocolate" ] }
{ "_id" : 4, "name" : "ty", "threeFavorites" : [ "ice cream" ] }