Interface : Carte

règles . Carte

interface statique

Type de carte, utilisé pour les mappages clé-valeur simples.

Les clés doivent être de type rules.String .

En plus des méthodes répertoriées ci-dessous, les cartes ont les opérateurs suivants :

Opérateur Usage
x == y Comparez les cartes x et y
x[k] Opérateur d'index, obtient la valeur au nom de clé k
xk Obtenir la valeur au nom de clé k
k in x Vérifiez si la clé k existe dans la carte x

Méthodes

différence

diff(map_to_compare) renvoie des règles.MapDiff

Renvoie un Rules.MapDiff représentant le résultat de la comparaison de la carte actuelle à une carte de comparaison.

Paramètre

map_to_compare

règles.Carte

Une Map à laquelle la Map actuelle (appelante) sera comparée.

La valeur ne doit pas être nulle.

Retour

Objet non-null rules.MapDiff représentant le résultat de la comparaison.

obtenir

get(key, default_value) renvoie la valeur

Renvoie la valeur associée à une chaîne de clé de recherche donnée.

Pour les Maps imbriquées, impliquant des clés et des sous-clés , renvoie la valeur associée à une chaîne de sous-clé donnée. La sous-clé est identifiée à l'aide d'une liste dont le premier élément est une clé de niveau supérieur et le dernier élément la sous-clé dont la valeur doit être recherchée et renvoyée. Voir l'exemple de carte imbriquée ci-dessous.

La fonction nécessite le retour d'une valeur par défaut si aucune correspondance avec la clé de recherche donnée n'est trouvée.

Paramètre

clé

( règles.String non nulles ou règles.Liste non nulles)

Soit une clé spécifiée sous forme de chaîne, soit pour les cartes imbriquées, une sous-clé spécifiée à l'aide de la syntaxe de liste.

valeur par défaut

valeur par défaut

Valeur à renvoyer si la carte ne contient pas la clé de recherche donnée. Il peut s'agir de n'importe quel type de langage de règles.

Retour

value Valeur correspondant à la key donnée, ou la valeur de retour par défaut spécifiée par default_value si aucune correspondance avec la clé donnée n'est trouvée. Étant donné que le contenu de la carte est défini par l'utilisateur, le type de données de la value renvoyée peut être n'importe quel type de langage de règles.

Exemple

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

clés

keys() renvoie les règles.Liste

Obtenez la liste des clés dans la carte.

Retour

non-null rules.List Liste des clés.

taille

size() renvoie des règles.Integer

Obtenez le nombre d'entrées dans la carte.

Retour

non-null rules.Integer Nombre entier d'entrées.

valeurs

valeurs() renvoie les règles.Liste

Obtenez la liste des valeurs dans la carte.

Retour

non-null rules.List Liste des valeurs.
  翻译：