Interfejs: Mapa

zasady . Mapa

interfejs statyczny

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

zasady.Mapa

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 podanemu key lub domyślna wartość zwracana określona przez default_value , jeśli nie znaleziono dopasowania do danego klucza. Ponieważ zawartość mapy jest definiowana przez użytkownika, typ danych zwracanej value 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.