zl.nth Reference

Extract item from list

zl.nth

Description

Extract an item from an incoming list, based on the index specified (starting at 1).

Arguments

initial-index [int]

Optional

Sets the initial index of item to extract. The index starts at 1.

index-sub [list]

Optional

Sets the index to extract (starting at 1) and replacement value to output in a list output from right outlet.

Attributes

fuzzy [atom] (default: 0.)

Fuzzy floating-point comparison epsilon

zlmaxsize [atom_long]

Maximum List Length

Common Box Attributes

Messages

bang

Repeat previous output

int

In right inlet:
Sets index to extract (starting at 1).

float

TEXT_HERE

list

In left inlet:
List to extract item from.

In right inlet:
Index to extract (starting at 1) and replacement value to output in list from right outlet.

anything

TEXT_HERE

mode

The word 'mode' followed by one of the following words will set the mode of the object:
change, compare, delace, ecils, group, indexmap, iter, join, lace, len, lookup, median, mth, nth, queue, reg, rev, rot, scramble, sect, slice, sort, stack, stream, sub, sum, swap, thin, union, or unique.

See the reference for the corresponding mode for more information.

zlclear

Clears the currently held list.

Output

anything

Out left outlet:
Extracted item.

list

Out right outlet:
List with item removed (or replaced, if a list was sent to the right inlet).

See Also

Name Description
zl
zl.change
zl.compare
zl.delace
zl.ecils
zl.filter
zl.group
zl.indexmap
zl.iter
zl.join
zl.lace
zl.len
zl.lookup
zl.median
zl.mth
zl.queue
zl.reg
zl.rev
zl.rot
zl.scramble
zl.sect
zl.slice
zl.sort
zl.stack
zl.stream
zl.sub
zl.sum
zl.swap
zl.thin
zl.union
zl.unique