index :: data

data.mlist

aliases: [ceammc/mlist], [mlist], [ceammc/ml], [ml]

the multidimensional list container

available since version: 0.6

---

information

Syntax: values are separated by spaces: (1 2 3) - list of 1, 2 and 3 Nested lists: (1 2 3 (nested list values)) Symbols with spaces: ("single item list")

arguments:

• VALUE initial list values in (). For example: (1 2 3 (1 2) 4)
  type: atom
  

methods:

• (….) sets new list without output
  

• append adds values to the end of the list
  parameters:
  • VAL appended value
    type: atom
    required: True
    
• at outputs atom at the specified position
  parameters:
  • IDX position (negative indexes are supported: -1 means last element)
    type: int
    required: True
    

• back output last list element
  

• choose choose random element in list and output it
  

• clear removes all list elements
  

• dump dump object info to Pd window
  

• fill fills with specified value
  parameters:
  • VAL fill value
    type: atom
    required: True
    

• front output first list element
  

• insert inserts values to the specified position
  parameters:

  • IDX insert position
    type: int
    required: True
    

  • VAL value
    type: atom
    required: True
    

• pop removes last list element
  

• prepend inserts values to the list beginning
  parameters:
  • VAL prepended value
    type: atom
    required: True
    
• remove removes specified element
  parameters:
  • IDX element index
    type: int
    required: True
    

• reverse reverses list
  

• set sets new list without output
  parameters:
  • LIST new list content
    type: list
    required: True
    

• shuffle put elements in random order
  

• sort sorts list
  

properties:

• @empty (readonly) Get 1 if list is empty, otherwise 0
  type: bool
  default: 1
  

• @size (readonly) Get number of elements in list
  type: int
  min value: 0
  default: 0
  

• @value Get/set mlist value
  type: atom
  default: []
  

inlets:

• output current list value
  type: control

outlets:

• output list or list elements
  type: control

keywords:

data multilist

See also: [data.list]

Authors: Serge Poltavsky

License: GPL3 or later