$slice (agregación)

Definición

$slice

Devuelve un subconjunto de un arreglo.

Nota

Desambiguación

Para obtener información sobre cómo limitar el tamaño de una matriz durante una actualización con $push, consulte el $slice modificador de actualización en su lugar.

Para el operador de proyección del comando find, consulte el operador de $slice proyección.

$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 expresión válida 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:

db.users.insertMany( [
   { _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" ] }
]