index :: data

data.dict

aliases: [ceammc/dict], [dict]

dictionary container: store values by key

available since version: 0.6

---

information

Syntax: [key1: value key2 : "with space"]. Nested dictionaries are supported: [a: [A:1 B:2]]).

methods:

• [….] sets new content without output
  

• add adds entry to dictionary
  parameters:

  • KEY entry key
    type: symbol
    required: True
    

  • VAL single value or list
    type: list
    required: True
    

• choose choose random key and output it
  

• clear removes all dict values. No output
  

• get_key get entry from dictionary
  parameters:
  • KEY entry key
    type: symbol
    required: True
    
• read read dict from JSON file
  parameters:
  • PATH file path
    type: symbol
    required: True
    
• remove remove entry from dictionary
  parameters:
  • KEY entry key
    type: symbol
    required: True
    

• set set dict content without output
  

• set_key change entry in dictionary. If it's not exists, do nothing.
  parameters:

  • KEY key
    type: symbol
    required: True
    

  • VAL single value or list
    type: list
    required: True
    

• write write dict as JSON file
  parameters:
  • PATH file path
    type: symbol
    required: True
    

properties:

• @keys (readonly) Get keys of dictionary
  type: list
  

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

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

inlets:

• output current dictionary value
  type: control

outlets:

• output dictionary
  type: control

keywords:

data dictionary

See also: [data.set] [data.mlist]

Authors: Serge Poltavsky

License: GPL3 or later