bottom-with-ties
sort-table →
bottom-with-ties(
count: integer
) → array
Returns the last count rows and all comparer-equal boundary ties in sort table order.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
count | integer | Yes | The requested row count before including boundary ties. |
Argument evaluation
count: Evaluated once in the surrounding evaluation context of this bottom-with-ties call; the SortTable supplied as pipeline input is used only for row selection.
Behavior
Uses the shared full SortTable comparator to include every row tied with the selection boundary. Results retain table order and stable source order within ties. Zero count and empty input return an empty array; oversized count returns all rows. Negative count fails with an argument error. Uses partial selection followed by a boundary scan and ordering of selected rows; invalid comparer results fail as for sort.
Kind: Function
Scope: sorting
Aliases: None