Macaulay2 » Documentation
Packages » Macaulay2Doc :: take
next | previous | forward | backward | up | index | toc

take -- Take some elements from a list or sequence.

Synopsis

Description

i1 : take({a,b,c,d,e,f,g}, 3)

o1 = {a, b, c}

o1 : List
i2 : take({a,b,c,d,e,f,g}, -3)

o2 = {e, f, g}

o2 : List
i3 : take({a,b,c,d,e,f,g}, {1,3})

o3 = {b, c, d}

o3 : List
i4 : take({a,b,c,d,e,f,g}, {2,2})

o4 = {c}

o4 : List

The pair \{j,k\} must be given with both entries non-negative, and $j\le k$. Otherwise an empty list is returned.

i5 : take({a,b,c,d,e,f,g}, {3,1})

o5 = {}

o5 : List
i6 : take({a,b,c,d,e,f,g}, {4,-1})

o6 = {}

o6 : List

If x is any object belonging to a class with the iterator method installed, then a list containing the first i objects returned when next is called on the output of iterator x is returned. If fewer then i objects are returned before the StopIteration symbol is encountered, then the list will have length less than i.

i7 : take("Hello, world!", 5)

o7 = {H, e, l, l, o}

o7 : List
i8 : take("Hello, world!", 20)

o8 = {H, e, l, l, o, ,,  , w, o, r, l, d, !}

o8 : List

See also

Ways to use take :

For the programmer

The object take is a compiled function.