Map-Funktionen

Name	Beschreibung
cardinality(map)	Gibt die Größe der Map zurück (bzw. die Anzahl der Einträge in der Map).
element_at(map, key)	Gibt den Wert für einen gegebenen key als Liste zurück, oder eine leere Liste, wenn der Schlüssel nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen; andernfalls wird ein Fehler ausgelöst.
map_concat(maps...)	Gibt eine Map zurück, die durch Zusammenführen der Eingabe-maps entsteht. Bei Schlüsselkollision wird der Wert aus der letzten Map mit diesem Schlüssel übernommen.
map_contains(map, key)	Prüft, ob eine Map einen gegebenen Schlüssel enthält.
map_contains_entry(map, key, value)	Prüft, ob eine Map ein gegebenes Schlüssel-Wert-Paar enthält.
map_contains_value(map, value)	Prüft, ob eine Map einen gegebenen Wert enthält.
map_entries(map)	Gibt eine Liste von struct(k, v) für jedes Schlüssel-Wert-Paar in der Map zurück.
map_extract(map, key)	Gibt den Wert für einen gegebenen key als Liste zurück, oder eine leere Liste, wenn der Schlüssel nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen; andernfalls wird ein Fehler ausgelöst.
map_extract_value(map, key)	Gibt den Wert für einen gegebenen key oder NULL zurück, wenn der key nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen; andernfalls wird ein Fehler ausgelöst.
map_from_entries(STRUCT(k, v)[])	Gibt eine Map zurück, die aus den Einträgen des Arrays erzeugt wird.
map_keys(map)	Gibt eine Liste aller Schlüssel in der Map zurück.
map_values(map)	Gibt eine Liste aller Werte in der Map zurück.
map()	Gibt eine leere Map zurück.
map[entry]	Gibt den Wert für einen gegebenen key oder NULL zurück, wenn der key nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen; andernfalls wird ein Fehler ausgelöst.

cardinality(map)

| Beschreibung | Gibt die Größe der Map zurück (bzw. die Anzahl der Einträge in der Map). | | Beispiel | cardinality(map([4, 2], ['a', 'b'])) | | Ergebnis | 2 |

element_at(map, key)

| Beschreibung | Gibt den Wert für einen gegebenen key als Liste zurück, oder eine leere Liste, wenn der Schlüssel nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen; andernfalls wird ein Fehler ausgelöst. | | Beispiel | element_at(map([100, 5], [42, 43]), 100) | | Ergebnis | [42] | | Aliase | map_extract(map, key) |

map_concat(maps...)

| Beschreibung | Gibt eine Map zurück, die durch Zusammenführen der Eingabe-maps entsteht. Bei Schlüsselkollision wird der Wert aus der letzten Map mit diesem Schlüssel übernommen. | | Beispiel | map_concat(MAP {'key1': 10, 'key2': 20}, MAP {'key3': 30}, MAP {'key2': 5}) | | Ergebnis | {key1=10, key2=5, key3=30} |

map_contains(map, key)

| Beschreibung | Prüft, ob eine Map einen gegebenen Schlüssel enthält. | | Beispiel | map_contains(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 'key2') | | Ergebnis | true |

map_contains_entry(map, key, value)

| Beschreibung | Prüft, ob eine Map ein gegebenes Schlüssel-Wert-Paar enthält. | | Beispiel | map_contains_entry(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 'key2', 20) | | Ergebnis | true |

map_contains_value(map, value)

| Beschreibung | Prüft, ob eine Map einen gegebenen Wert enthält. | | Beispiel | map_contains_value(MAP {'key1': 10, 'key2': 20, 'key3': 30}, 20) | | Ergebnis | true |

map_entries(map)

| Beschreibung | Gibt eine Liste von struct(k, v) für jedes Schlüssel-Wert-Paar in der Map zurück. | | Beispiel | map_entries(map([100, 5], [42, 43])) | | Ergebnis | [{'key': 100, 'value': 42}, {'key': 5, 'value': 43}] |

map_extract(map, key)

| Beschreibung | Gibt den Wert für einen gegebenen key als Liste zurück oder NULL, wenn der Schlüssel nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen, andernfalls wird ein Fehler zurückgegeben. | | Beispiel | map_extract(map([100, 5], [42, 43]), 100) | | Ergebnis | [42] | | Aliase | element_at(map, key) |

map_extract_value(map, key)

| Beschreibung | Gibt den Wert für einen gegebenen key oder NULL zurück, wenn der key nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen; andernfalls wird ein Fehler ausgelöst. | | Beispiel | map_extract_value(map([100, 5], [42, 43]), 100); | | Ergebnis | 42 | | Aliase | map[key] |

map_from_entries(STRUCT(k, v)[])

| Beschreibung | Gibt eine Map zurück, die aus den Einträgen des Arrays erzeugt wird. | | Beispiel | map_from_entries([{k: 5, v: 'val1'}, {k: 3, v: 'val2'}]) | | Ergebnis | {5=val1, 3=val2} |

map_keys(map)

| Beschreibung | Gibt eine Liste aller Schlüssel in der Map zurück. | | Beispiel | map_keys(map([100, 5], [42,43])) | | Ergebnis | [100, 5] |

map_values(map)

| Beschreibung | Gibt eine Liste aller Werte in der Map zurück. | | Beispiel | map_values(map([100, 5], [42, 43])) | | Ergebnis | [42, 43] |

map()

| Beschreibung | Gibt eine leere Map zurück. | | Beispiel | map() | | Ergebnis | {} |

map[entry]

| Beschreibung | Gibt den Wert für einen gegebenen key oder NULL zurück, wenn der key nicht in der Map enthalten ist. Der Typ des im zweiten Parameter angegebenen Schlüssels muss mit dem Typ der Map-Schlüssel übereinstimmen; andernfalls wird ein Fehler ausgelöst. | | Beispiel | map([100, 5], ['a', 'b'])[100] | | Ergebnis | a | | Aliase | map_extract_value(map, key) |