$slice (operador de expresión)

Definición

$slice

Devuelve un subconjunto de un arreglo.

Nota

Desambiguación

Para información sobre cómo limitar el tamaño de un arreglo durante una actualización con $push, consulta el modificador de actualización $slice.

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 un arreglo.
<position>	opcional. Cualquier expresión válida, siempre que resuelva a un entero. Si es positivo, $slice determina la posición inicial desde el inicio 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 su resultado sea un número entero. Si se especifica <position>, <n> debe resolverse como un número 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 en un número negativo si se especifica <position>.

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