$slice (agregación)

Definición

$slice

Nuevo en la versión 3.2.

Devuelve un subconjunto de un arreglo.

$slice tiene una de dos formas de sintaxis:

La siguiente sintaxis devuelve elementos del inicio o del final de la matriz:

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

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

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

Operando	Descripción
<array>	Cualquier válido 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, determina la posición inicial desde el inicio del array. $slice Si <position> es mayor que el número de elementos, devuelve un array $slice vacío. Si es negativo, determina la posición inicial desde el final del array. Si el valor absoluto$slice de <position> es mayor que el número de elementos, la posición inicial es el inicio del array.
<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$slice es positivo, devuelve hasta los primeros n elementos de la matriz. Si <position> se especifica, devuelve los$slice primeros n elementos a partir de la posición. Si$slice es negativo, devuelve hasta los últimos n elementos de la matriz. n no puede resolverse en un número negativo si <position> se especifica.

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 de la matriz 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" ] }