Interfaccia: mappa

regole . Carta geografica

interfaccia statica

Tipo di mappa, utilizzato per semplici mappature di valori-chiave.

Le chiavi devono essere di tipo rules.String .

Oltre ai metodi elencati di seguito, le mappe dispongono dei seguenti operatori:

Operatore Utilizzo
x == y Confronta le mappe x e y
x[k] Operatore dell'indice, ottiene il valore nel nome della chiave k
xk Ottieni valore al nome della chiave k
k in x Controlla se la chiave k esiste nella mappa x

Metodi

diff

diff(map_to_compare) restituisce regole.MapDiff

Restituisce un rule.MapDiff che rappresenta il risultato del confronto tra la mappa corrente e una mappa di confronto.

Parametro

mappa_per_confrontare

regole.Mappa

Una mappa con cui verrà confrontata la mappa corrente (chiamante).

Il valore non deve essere nullo.

ritorna

oggetto non-null rules.MapDiff che rappresenta il risultato del confronto.

Ottenere

get(chiave, valore_predefinito) restituisce valore

Restituisce il valore associato a una determinata stringa di chiave di ricerca.

Per le mappe nidificate, che coinvolgono chiavi e sottochiavi , restituisce il valore associato a una determinata stringa di sottochiave. La sottochiave viene identificata utilizzando un elenco, il primo elemento del quale è una chiave di livello superiore e l'ultimo elemento la sottochiave il cui valore deve essere cercato e restituito. Vedi l'esempio di mappa nidificata di seguito.

La funzione richiede un valore predefinito da restituire se non viene trovata alcuna corrispondenza con la chiave di ricerca specificata.

Parametro

chiave

( regole non nulle.String o regole non nulle.List )

Una chiave specificata come stringa o, per le mappe nidificate, una sottochiave specificata utilizzando la sintassi dell'elenco.

valore di default

valore di default

Valore da restituire se la mappa non contiene la chiave di ricerca specificata. Può essere qualsiasi tipo di linguaggio delle regole.

ritorna

value Valore corrispondente alla key specificata o valore restituito predefinito specificato da default_value se non viene trovata alcuna corrispondenza con la chiave specificata. Poiché i contenuti della mappa sono definiti dall'utente, il tipo di dati del value restituito può essere qualsiasi tipo di linguaggio delle regole.

Esempio

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

chiavi

keys() restituisce regole.Lista

Ottieni l'elenco delle chiavi nella mappa.

ritorna

non-null rules.List elenco di chiavi.

misurare

size() restituisce regole.Intero

Ottieni il numero di voci nella mappa.

ritorna

non-null rules.Integer Numero intero di voci.

valori

valori() restituisce regole.Lista

Ottieni l'elenco dei valori nella mappa.

ritorna

non-null rules.List Elenco di valori.