regras . Mapa
Tipo de mapa, usado para mapeamentos de valores-chave simples.
As chaves devem ser do tipo rules.String
.
Além dos métodos listados abaixo, os mapas têm os seguintes operadores:
Operador | Uso |
---|---|
x == y | Compare os mapas x e y |
x[k] | Operador de índice, obtenha valor no nome-chave k |
xk | Obtenha 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 regras.MapDiff
Retorne um rules.MapDiff que representa o resultado da comparação do Mapa atual com um Mapa de comparação.
Parâmetro | |
---|---|
map_to_compare | Um mapa com o qual o mapa atual (chamador) será comparado. O valor não deve ser nulo. |
- Devoluções
objeto
non-null rules.MapDiff
representa o resultado da comparação.
obter
get (key, default_value) retorna o valor
Retorna o valor associado a uma determinada string de chave de pesquisa.
Para mapas aninhados, envolvendo chaves e subchaves , retorna o valor associado a uma determinada string de subchave. A subchave é identificada usando uma lista, o primeiro item da qual é uma chave de nível superior e o último item a subchave cujo valor deve ser pesquisado e retornado. Veja o exemplo de mapa aninhado abaixo.
A função requer um valor padrão para retornar se nenhuma correspondência para a chave de pesquisa fornecida for encontrada.
Parâmetro | |
---|---|
chave | ( regras não nulas.Regras de string ou não nulas.Lista ) Uma chave especificada como string ou, para mapas aninhados, uma subchave especificada usando a sintaxe de lista. |
valor padrão | valor padrão Valor a ser retornado se o mapa não contiver a chave de pesquisa fornecida. Pode ser qualquer tipo de linguagem de regras. |
- Devoluções
value
Valor correspondente àkey
fornecida ou o valor de retorno padrão especificado pordefault_value
se nenhuma correspondência com a chave fornecida for encontrada. Como o conteúdo do mapa é definido pelo usuário, o tipo de dados dovalue
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 regras.List
Obtenha a lista de chaves no mapa.
- Devoluções
non-null rules.List
lista de chaves.
Tamanho
size () retorna regras.Integer
Obtenha o número de entradas no mapa.
- Devoluções
non-null rules.Integer
Númeronon-null rules.Integer
de entradas.
valores
valores () retorna regras.Lista
Obtenha a lista de valores no mapa.
- Devoluções
non-null rules.List
lista de valores.