règles . Carte
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 | Une Map à laquelle la Map actuelle (appelante) sera comparée. La valeur ne doit pas être nulle. |
- Retour
Objet
non-null rules.MapDiffrepré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
valueValeur correspondant à lakeydonnée, ou la valeur de retour par défaut spécifiée pardefault_valuesi 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 lavaluerenvoyé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) == 1clés
keys() renvoie les règles.Liste
Obtenez la liste des clés dans la carte.
- Retour
non-null rules.ListListe des clés.
taille
size() renvoie des règles.Integer
Obtenez le nombre d'entrées dans la carte.
- Retour
non-null rules.IntegerNombre entier d'entrées.
valeurs
valeurs() renvoie les règles.Liste
Obtenez la liste des valeurs dans la carte.
- Retour
non-null rules.ListListe des valeurs.