(optional) positive or negative integer, or list/set of positive or negative integers, specifying which sub-containers are to be returned. The default is [seq(1..numslices)].

Description

•

The command slices a container into a sequence of sub-containers with the number of elements in each sub-container differing by at most one.

•

If not all the sub-containers are of the same length, the longer containers appear first.

•

Elements in the returned sequence of sub-containers appear in the same order as the original container.

•

If the specified number of sub-containers is greater than the number of elements in the original container, then the container is sliced into sub-containers of single elements, followed by empty sub-containers.

•

When the optional parameter slicesreturned is passed, only the specified sub-containers are computed and returned. Note that an error will be thrown if 0, or any number larger than numslices or smaller than -numslices, is passed.

•

If a 1-D rtable is to be passed, it can have any integer as initial index, but the initial indices of the returned rtables will all be 1.

Examples

$with (ListTools) &colon;$

Example 1

$Slice ([], 1)$

$[]$

(1)

$Slice ([], 2)$

$[], []$

(2)

Example 2

$L ≔ [a, b, c, d, e]$

(3)

$Slice (L, 1)$

$[a, b, c, d, e]$

(4)

$Slice (L, 2)$

$[a, b, c], [d, e]$

(5)

$Slice (L, 3)$

$[a, b], [c, d], [e]$

(6)

$Slice (L, 4)$

$[a, b], [c], [d], [e]$

(7)

$Slice (L, 5)$

$[a], [b], [c], [d], [e]$

(8)

$Slice (L, 6)$

$[a], [b], [c], [d], [e], []$

(9)

$Slice (L, 3, [1, 3])$

$[a, b], [e]$

(10)

$Slice (L, 3, 2)$

$[c, d]$

(11)

Example 3

$S ≔ \{a, b, c, d\}$

(12)

$Slice (S, 3)$

$\{a, b\}, \{c\}, \{d\}$

(13)

Example 4

$V ≔ ⟨seq (1 .. 12)⟩$

$V ≔ \begin{matrix} [\begin{matrix} 1 \\ 2 \\ 3 \\ 4 \\ 5 \\ 6 \\ 7 \\ 8 \\ 9 \\ 10 \\ ⋮ \end{matrix}] \\ 12 element Vector[column] \end{matrix}$

(14)

$Slice (V, 3)$

$[\begin{matrix} 1 \\ 2 \\ 3 \\ 4 \end{matrix}], [\begin{matrix} 5 \\ 6 \\ 7 \\ 8 \end{matrix}], [\begin{matrix} 9 \\ 10 \\ 11 \\ 12 \end{matrix}]$

(15)

$Slice (V, 4, [1, - 1])$

$[\begin{matrix} 1 \\ 2 \\ 3 \end{matrix}], [\begin{matrix} 10 \\ 11 \\ 12 \end{matrix}]$

(16)

Compatibility

•

The ListTools[Slice] command was introduced in Maple 2020.

•

For more information on Maple 2020 changes, see Updates in Maple 2020 .

•

The ListTools[Slice] command was updated in Maple 2021.

•

The Container parameter was updated in Maple 2021.

•

The slicesreturned option was introduced in Maple 2021.

•

For more information on Maple 2021 changes, see Updates in Maple 2021 .

Maple

Powerful math software that is easy to use

Maple Add-Ons

Math Success Platform

Improving Retention Rates

Maple Flow

Engineering calculations & documentation

MapleSim

Advanced System Level Modeling

Consulting Services

Maple T.A. and Möbius

Education

Industries

Automotive and Aerospace

Robotics

Machine Design & Industrial Automation

Other

Application Areas

Product Pricing

Purchasing

Institutional Student Licensing

Maplesoft Elite Maintenance (EMP)

Support

Product Training

Online Product Help

Webinars & Events

Publications

Content Hubs

Examples & Applications

Community

About Maplesoft

Media Center

User Community

Contact

Online Help

All Products Maple MapleSim

November 5-7, 2025 • Free Virtual Event