Schnittstelle: Karte

Regeln . Karte

Schnittstelle statisch

Kartentyp, der für einfache Schlüsselwertzuordnungen verwendet wird.

Schlüssel müssen vom Typ rules.String sein.

Zusätzlich zu den unten aufgeführten Methoden verfügen Karten über die folgenden Operatoren:

---

Operator	Verwendung
x == y	Vergleichen Sie die Karten x und y
x[k]	Indexoperator, Wert am Schlüsselnamen k abrufen
xk	Wert am Schlüsselnamen k abrufen
k in x	Überprüfen Sie, ob der Schlüssel k in Karte x vorhanden ist

Methoden

diff

diff(map_to_compare) gibt Rules.MapDiff zurück

Gibt eine Rules.MapDiff zurück, die das Ergebnis des Vergleichs der aktuellen Map mit einer Vergleichs-Map darstellt.

Parameter
map_to_compare	Regeln.Karte Eine Map, mit der die aktuelle (aufrufende) Map verglichen wird. Der Wert darf nicht null sein.

Kehrt zurück

non-null rules.MapDiff Objekt, das das Ergebnis des Vergleichs darstellt.

erhalten

get(key, default_value) gibt einen Wert zurück

Gibt den Wert zurück, der einer bestimmten Suchschlüsselzeichenfolge zugeordnet ist.

Bei verschachtelten Karten mit Schlüsseln und Unterschlüsseln wird der Wert zurückgegeben, der einer bestimmten Unterschlüsselzeichenfolge zugeordnet ist. Der Unterschlüssel wird mithilfe einer Liste identifiziert, deren erstes Element ein Schlüssel der obersten Ebene und das letzte Element der Unterschlüssel ist, dessen Wert gesucht und zurückgegeben werden soll. Sehen Sie sich das Beispiel einer verschachtelten Karte unten an.

Die Funktion erfordert die Rückgabe eines Standardwerts, wenn keine Übereinstimmung mit dem angegebenen Suchschlüssel gefunden wird.

Parameter
Schlüssel	(Nicht-Null- Regeln.String oder Nicht-Null- Regeln.Liste ) Entweder ein als String angegebener Schlüssel oder bei verschachtelten Karten ein Unterschlüssel, der mithilfe der Listensyntax angegeben wird.
Standardwert	Standardwert Wert, der zurückgegeben werden soll, wenn die Karte den angegebenen Suchschlüssel nicht enthält. Kann ein beliebiger Regelsprachentyp sein.

Kehrt zurück

value Wert, der dem angegebenen key entspricht, oder der durch default_value angegebene Standardrückgabewert, wenn keine Übereinstimmung mit dem angegebenen Schlüssel gefunden wird. Da Karteninhalte benutzerdefiniert sind, kann der Datentyp des zurückgegebenen value ein beliebiger Rules-Sprachtyp sein.

Beispiel

// "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

Schlüssel

„keys()“ gibt „rules.List“ zurück

Rufen Sie die Liste der Schlüssel in der Karte ab.

Kehrt zurück

non-null rules.List Liste der Schlüssel.

Größe

size() gibt Rules.Integer zurück

Ermitteln Sie die Anzahl der Einträge in der Karte.

Kehrt zurück

non-null rules.Integer Anzahl von Einträgen.

Werte

Values() gibt Rules.List zurück

Rufen Sie die Liste der Werte in der Karte ab.

Kehrt zurück

non-null rules.List Liste der Werte.