$slice (operador de expresió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 proyección $slice en su lugar.

$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>	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, $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:

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 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" ] }
]