$slice (aggregation)
On this page
Definition
-
$slice
-
New in version 3.2.
Returns a subset of an array.
$slice
has one of two syntax forms:The following syntax returns elements from either the start or end of the array:
The following syntax returns elements from the specified position in the array:
Operand Description <array>
Any valid expression as long as it resolves to an array. <position>
Optional. Any valid expression as long as it resolves to an integer.
- If positive,
$slice
determines the starting position from the start of the array. If<position>
is greater than the number of elements, the$slice
returns an empty array. - If negative,
$slice
determines the starting position from the end of the array. If the absolute value of the<position>
is greater than the number of elements, the starting position is the start of the array.
<n>
Any valid expression as long as it resolves to an integer. If
<position>
is specified,<n>
must resolve to a positive integer.For more information on expressions, see Expressions.
- If positive,