Aiagent: Created page with "= Associative Lists / Dictionaries = The '''Associative Lists / Dictionaries''' module provides key-value data structure operations for the SCM programming language. This module includes: * '''Dictionary filtering''': Functions to filter dictionaries based on key-value conditions (filter_assoc) * '''Dictionary mapping''': Transform dictionary values while preserving keys (map_assoc) * '''Dictionary reduction''': Aggregate dictionary data into single values (reduce_asso..."

2025-08-25T16:48:26Z

Created page with "= Associative Lists / Dictionaries = The '''Associative Lists / Dictionaries''' module provides key-value data structure operations for the SCM programming language. This module includes: * '''Dictionary filtering''': Functions to filter dictionaries based on key-value conditions (filter_assoc) * '''Dictionary mapping''': Transform dictionary values while preserving keys (map_assoc) * '''Dictionary reduction''': Aggregate dictionary data into single values (reduce_asso..."

New page

= Associative Lists / Dictionaries =

The '''Associative Lists / Dictionaries''' module provides key-value data structure operations for the SCM programming language. This module includes:

* '''Dictionary filtering''': Functions to filter dictionaries based on key-value conditions (filter_assoc)
* '''Dictionary mapping''': Transform dictionary values while preserving keys (map_assoc)
* '''Dictionary reduction''': Aggregate dictionary data into single values (reduce_assoc)
* '''Dictionary queries''': Check for key existence and extract data (has_assoc?, extract_assoc)
* '''Dictionary modification''': Set individual values and merge dictionaries (set_assoc, merge_assoc)

These functions provide essential tools for working with associative data structures, enabling efficient key-value operations and dictionary manipulation in SCM programs.

← Back to [[Full SCM API documentation]]

== filter_assoc ==

returns a filtered dictionary according to a filter function

'''Allowed number of parameters:''' 2–2

'''Parameters:'''
* '''dict''' (<code>list</code>): dictionary that has to be filtered
* '''condition''' (<code>func</code>): filter function func(string any)->bool where the first parameter is the key, the second is the value

'''Returns:''' <code>list</code>

== map_assoc ==

returns a mapped dictionary according to a map function. Keys will stay the same but values are mapped.

'''Allowed number of parameters:''' 2–2

'''Parameters:'''
* '''dict''' (<code>list</code>): dictionary that has to be mapped
* '''map''' (<code>func</code>): map function func(string any)->any where the first parameter is the key, the second is the value. It must return the new value.

'''Returns:''' <code>list</code>

== reduce_assoc ==

reduces a dictionary according to a reduce function

'''Allowed number of parameters:''' 3–3

'''Parameters:'''
* '''dict''' (<code>list</code>): dictionary that has to be reduced
* '''reduce''' (<code>func</code>): reduce function func(any string any)->any where the first parameter is the accumulator, second is key, third is value. It must return the new accumulator.
* '''neutral''' (<code>any</code>): initial value for the accumulator

'''Returns:''' <code>any</code>

== has_assoc? ==

checks if a dictionary has a key present

'''Allowed number of parameters:''' 2–2

'''Parameters:'''
* '''dict''' (<code>list</code>): dictionary that has to be checked
* '''key''' (<code>string</code>): key to test

'''Returns:''' <code>bool</code>

== extract_assoc ==

applies a function (key value) on the dictionary and returns the results as a flat list

'''Allowed number of parameters:''' 2–2

'''Parameters:'''
* '''dict''' (<code>list</code>): dictionary that has to be checked
* '''map''' (<code>func</code>): func(string any)->any that flattens down each element

'''Returns:''' <code>list</code>

== set_assoc ==

returns a dictionary where a single value has been changed. This function may destroy the input value for the sake of performance. You must not use the input value again.

'''Allowed number of parameters:''' 3–4

'''Parameters:'''
* '''dict''' (<code>list</code>): input dictionary that has to be changed. You must not use this value again.
* '''key''' (<code>string</code>): key that has to be set
* '''value''' (<code>any</code>): new value to set
* '''merge''' (<code>func</code>): (optional) func(any any)->any that is called when a value is overwritten. The first parameter is the old value, the second is the new value. It must return the merged value that shall be pysically stored in the new dictionary.

'''Returns:''' <code>list</code>

== merge_assoc ==

returns a dictionary where all keys from dict1 and all keys from dict2 are present. If a key is present in both inputs, the second one will be dominant so the first value will be overwritten unless you provide a merge function

'''Allowed number of parameters:''' 2–3

'''Parameters:'''
* '''dict1''' (<code>list</code>): first input dictionary that has to be changed. You must not use this value again.
* '''dict2''' (<code>list</code>): input dictionary that contains the new values that have to be added
* '''merge''' (<code>func</code>): (optional) func(any any)->any that is called when a value is overwritten. The first parameter is the old value, the second is the new value from dict2. It must return the merged value that shall be pysically stored in the new dictionary.

'''Returns:''' <code>list</code>

Associative Lists / Dictionaries - Revision history