$slice (agregação)

Definição

$slice

Retorna um subconjunto de uma array.

Observação

Desambiguação

Para informações sobre como limitar o tamanho de uma array durante uma atualização com $push, consulte o modificador de atualização $slice.

Para o operador de projeção do comando "find", consulte o operador de projeção $slice.

$slice tem um dos dois formatos de sintaxe:

A seguinte sintaxe retorna elementos a partir do início ou final da array:

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

A seguinte sintaxe retorna elementos da posição especificada na array:

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

Operando	Descrição
<array>	Qualquer expressão válida, desde que seja resolvida para uma array.
<position>	Opcional. Qualquer expressão válida, desde que resolva para um número inteiro. Se positivo, determina a posição inicial desde o início da$slice array. Se <position> for maior que o número de elementos, o retornará uma array $slice vazia. Se negativo, determina a posição inicial a partir do final da$slice array. Se o valor absoluto do <position> for maior que o número de elementos, a posição inicial é o início da array.
<n>	Qualquer expressão válida, desde que resolva para um número inteiro. Se <position> for especificado, <n> deverá ser resolvido para um número inteiro positivo. Se positivo, retorna até os$slice primeiros n elementos da array. Se <position> for especificado, retornará os$slice primeiros n elementos a partir da posição. Se negativo, retornará até os$slice últimos n elementos na array. n não pode resolver para um número negativo se <position> for especificado.

Para mais informações sobre expressões, consulte Expressões.

Comportamento

{ $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 ]

Exemplo

Uma coleção chamada users contém os seguintes 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" ] }
] )

O exemplo seguinte retorna, no máximo, os três primeiros elementos na array favorites para cada usuário:

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

A operação retorna os seguintes 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" ] }
]