Interface: Mapa

regras . Mapa

interface estática

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

regras.Mapa

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 por default_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 do value 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úmero non-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.