Interfejs: mapa

rules.Mapa

interfejs   statyczny

Typ mapy używany do prostych mapowań par klucz-wartość.

Klucze muszą być typu rules.String.

Oprócz wymienionych poniżej metod mapy mają te operatory:

---

Operator	Wykorzystanie
x == y	Porównaj mapy x i y
x[k]	Operator indeksu, pobierz wartość w nazwie klucza k
x.k	Pobranie wartości w przypadku nazwy klucza k
k in x	Sprawdź, czy klucz k istnieje na mapie x

Metody

różnice

diff(map_to_compare) zwraca rules.MapDiff

Zwraca rules.MapDiff reprezentującą wynik porównania z bieżącą mapę porównawczą.

Parametr
mapa_do_porównania	rules.Map, Mapa, do której bieżąca (wywołająca) mapa zostanie porównany. Wartość nie może być pusta.

Zwraca

non-null rules.MapDiff obiekt reprezentujący wynik porównania.

get

get(key, default_value) zwraca wartość

Zwraca wartość powiązaną z podanym ciągiem znaków wyszukiwania.

W przypadku zagnieżdżonych map, które obejmują klucze i klucze podrzędne, zwraca wartość powiązane z danym ciągiem podrzędnym klucza. Klucz podrzędny jest rozpoznawany za pomocą pierwszy element to klucz najwyższego poziomu, a ostatnim podklucz, którego wartość ma zostać odszukana i zwrócona. Wyświetlanie zagnieżdżonej mapy przykład poniżej.

Funkcja wymaga wartości domyślnej do zwrócenia, jeśli nie ma dopasowania do podany klucz wyszukiwania.

Parametr
klucz	(wartość rules.String lub rules.List jest inna niż wartość null) Określono klucz jako ciąg znaków, a w przypadku zagnieżdżonych map – podklucz określony za pomocą składni listy.
wartość_domyślna	wartość_domyślna Wartość do zwrócenia, jeśli mapa nie zawiera podanego klucza wyszukiwania. Może to być dowolny język Reguły.

Zwraca

value Wartość odpowiadająca określonej funkcji key lub domyślna wartość zwracana określona przez default_value, jeśli brak dopasowania do podany klucz. Ponieważ treści mapy są definiowane przez użytkownika, typ danych zwrócony value może być dowolnym językiem 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

key() zwraca rules.List,

Pobierz listę kluczy z mapy.

Zwraca

Lista kluczy: non-null rules.List.

rozmiar

size() zwraca reguły.Integer

Sprawdź liczbę wpisów na mapie.

Zwraca

Liczba wpisów: non-null rules.Integer.

wartości

value() zwraca rules.List

Pobieranie listy wartości na mapie.

Zwraca

Lista wartości: non-null rules.List.