A newer version of Max is available. Click here to access the latest version of the Max documentation

list.sub Reference

output position for each occurrence of right list in left list

list.sub

Examples

Arguments

input2 [list]

Optional

The list that is searched for in the left list. This list of one or more elements must be matched exactly in the left list.

Inlets

input1 [list]

The list to be evaluated against the right list.

input2 [list]

The list that is searched for in the left list. This list of one or more elements must be matched exactly in the left list.

Outlets

offset [number]

The left outlet list is an index of the starting positions for each match in the incoming left list.

matches [number]

The right outlet outputs the total number of matched lists (as opposed to elements) from the left input list.

Fixed Attributes

These attributes must be set in the object box and determine the behavior of the object at runtime.

base [number] (default: 1)

Sets whether reported position index starts from 0 or 1.

Dynamic Attributes

These attributes can be modified in the code during execution using the set object

input1 [list]

The list to be evaluated against the right list.

input2 [list]

The list that is searched for in the left list. This list of one or more elements must be matched exactly in the left list.

reset [bang]

reset

See Also

Name Description
zl Process lists in many ways
zl.sub Output position for each occurance of right list in left
list.change Filter out repetitions (similar to zl.change)
list.compare Compare lists and output non-matching indexes (similar to zl.compare)
list.delace Delace, de-interleave a list. (similar to zl.delace)
list.ecils Slices a list in reverse order. (similar to zl.ecils)
list.filter Filter items in list b out of list a. (similar to zl.filter)
list.indexmap Create a new list based on the indices of an incoming list
list.group Output a list after N items are received. (similar to zl.group)
list.join join two lists (similar to zl.join)
list.lace Lace, interleave two lists
list.len Length of a list
list.lookup Output the nth element(s) of the right list. (similar to zl.lookup)
list.median Output the median of a list of numbers. (similar to zl.median)
list.mth Output and remove element of a list (0-based)
list.nth Output and remove element of a list (1-based)
list.queue Queue, FIFO message storage (First In, First Out)
list.reg Store a list, bang it out.
list.rev Reverse a list
list.rot Rotate a list
list.scramble Scramble the order of a list
list.sect Output what is in common between two lists. (similar to zl.sect)
list.slice Slices input list into two lists
list.sort Returns a sorted list of numbers. (similar to zl.sort)
list.stack Last in, first out message memory
list.stream Make a list with the last N items. (similar to zl.stream)
list.sum Sum a list of numbers. (similar to zl.sum)
list.swap Swap two list indexes
list.thin Remove duplicates from a list. (similar to zl.thin)
list.union Remove duplicates from a list. (similar to zl.union)
list.unique Output items in left list that are not in right list
list.unjoin
listfunnel Index and output list elements
Max Data Tutorial 5: List Processing Max Data Tutorial 5: List Processing