zasady . Mapa
Typ mapy używany do prostych mapowań klucz-wartość.
Klucze muszą być typu rules.String
.
Oprócz metod wymienionych poniżej mapy mają następujące operatory:
Operator | Stosowanie |
---|---|
x == y | Porównaj mapy x i y |
x[k] | Operator indeksu, pobierz wartość z nazwy klucza k |
xk | Uzyskaj wartość pod nazwą klucza k |
k in x | Sprawdź, czy klucz k istnieje na mapie x |
Metody
różnica
diff(map_to_compare) zwraca reguły.MapDiff
Zwróć regułę.MapDiff reprezentującą wynik porównania bieżącej mapy z mapą porównawczą.
Parametr | |
---|---|
map_do_porównania | Mapa, z którą zostanie porównana bieżąca (wywołująca) mapa. Wartość nie może mieć wartości null. |
- Zwroty
non-null rules.MapDiff
Obiekt MapDiff reprezentujący wynik porównania.
Dostawać
get(key, default_value) zwraca wartość
Zwraca wartość powiązaną z danym ciągiem klucza wyszukiwania.
W przypadku zagnieżdżonych Map, obejmujących klucze i podklucze , zwraca wartość powiązaną z danym ciągiem podkluczy. Podklucz identyfikowany jest za pomocą listy, której pierwsza pozycja to klucz najwyższego poziomu, a ostatnia pozycja to podklucz, którego wartość ma zostać wyszukana i zwrócona. Zobacz przykład zagnieżdżonej mapy poniżej.
Funkcja wymaga zwrócenia wartości domyślnej, jeśli nie zostanie znalezione dopasowanie do podanego klucza wyszukiwania.
Parametr | |
---|---|
klucz | ( reguły inne niż null.String lub reguły inne niż null.List ) Albo klucz określony jako ciąg znaków, albo w przypadku zagnieżdżonych map, podklucz określony przy użyciu składni listy. |
domyślna wartość | domyślna wartość Wartość do zwrócenia, jeśli Mapa nie zawiera podanego klucza wyszukiwania. Może to być dowolny typ języka Reguł. |
- Zwroty
value
Wartość odpowiadająca podanemukey
lub domyślna wartość zwracana określona przezdefault_value
, jeśli nie znaleziono dopasowania do danego klucza. Ponieważ zawartość mapy jest definiowana przez użytkownika, typ danych zwracanejvalue
może być dowolnym typem języka reguł.
Przykład
// "c" is not a key in the supplied Map, returns default value 7.
{"a": 3,"b": 2}.get("c", 7) == 7
// Default result can be any type, e.g. a list such as [1, 1].
{"a": [2, 7], "b": [9, 12]}.get("c", [1, 1]) == [1, 1]
// Return a list on a successful match.
{"a": [2, 7],"b": [9, 12]}.get("b", [1, 1]) == [9, 12]
// For nested Maps, use list ["a", "b"] to specify lookup on sub-key "b".
{"a": {"b": 1},"c": 2}.get(["a", "b"], 7) == 1
Klucze
klucze() zwraca reguły.Lista
Pobierz listę kluczy na mapie.
- Zwroty
non-null rules.List
listę kluczy.
rozmiar
size() zwraca reguły.Liczba całkowita
Uzyskaj liczbę wpisów na mapie.
- Zwroty
non-null rules.Integer
liczba wpisów.
wartości
wartości() zwraca reguły.Lista
Pobierz listę wartości na mapie.
- Zwroty
non-null rules.List
listę wartości.