rules. Mapear
Tipo de mapa, usado para mapeamentos de chave-valor simples.
As chaves precisam ser do tipo rules.String
.
Além dos métodos listados abaixo, os mapas têm os seguintes operadores:
Operador | Uso |
---|---|
x == y |
Comparar os mapas x e y |
x[k] |
Operador de índice, obter valor no nome da chave k |
x.k |
Obter valor no nome da chave k |
k in x |
Verifique se a chave k existe no mapa x |
Métodos
diferença
diff(map_to_compare) retorna rules.MapDiff
Retorne um rules.MapDiff representando o resultado da comparação do Map atual para um Mapa de comparação.
Parâmetro |
|
---|---|
mapear_a_comparar |
rules.Map (em inglês) Um mapa para o qual o mapa (chamada) atual serão comparados. O valor não pode ser nulo. |
- Retorna
-
Objeto
non-null rules.MapDiff
que representa o resultado da comparação.
get
get(key, default_value) retorna valor
Retorna o valor associado a determinada string de chave de pesquisa.
Para mapas aninhados, que envolvem chaves e subchaves, retorna o valor associados a uma determinada string de subchave. A subchave é identificada usando-se lista. O primeiro item é uma chave de nível superior, e o último é uma chave de nível superior. subchave cujo valor deve ser pesquisado e retornado. Ver o mapa aninhado exemplo abaixo.
A função requer um valor padrão a ser retornado se não houver correspondência para em que a chave de pesquisa especificada é encontrada.
Parâmetro |
|
---|---|
chave |
(rules.String não nulas ou rules.List não nulas) Uma chave especificada como uma string ou, para mapas aninhados, uma subchave especificada usando a sintaxe de lista. |
default_value |
default_value Valor a ser retornado se Map não contém a chave de pesquisa fornecida. Pode ser qualquer tipo de linguagem de regras. |
- Retorna
-
value
: o valor correspondente aokey
fornecido ou o valor de retorno padrão especificado pordefault_value
se não houver correspondência para em que a chave especificada é encontrada. Como o conteúdo do mapa é definido pelo usuário, o tipo de dados de ovalue
retornado pode ser qualquer tipo de linguagem de regras.
Exemplo
// "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
chaves
keys() retorna rules.List.
Confira a lista de chaves no mapa.
- Retorna
-
non-null rules.List
lista de chaves.
tamanho
size() retorna rules.Integer.
Descubra o número de entradas no mapa.
- Retorna
-
non-null rules.Integer
número de entradas.
values
values() retorna rules.List
Receba a lista de valores no mapa.
- Retorna
-
non-null rules.List
lista de valores.