Interface: Mapa

regras . Mapa

interface estática

Tipo de mapa, usado para mapeamentos simples de valores-chave.

As chaves devem ser do tipo rules.String .

Além dos métodos listados abaixo, os mapas possuem os seguintes operadores:

Operador Uso
x == y Compare os mapas x e y
x[k] Operador de índice, obtém valor no nome da chave k
xk Obtenha o 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

Retorna um regras.MapDiff representando o resultado da comparação do mapa atual com um mapa de comparação.

Parâmetro

map_to_compare

regras.Mapa

Um mapa ao qual o mapa atual (de chamada) será comparado.

O valor não deve ser nulo.

Devoluções

Objeto non-null rules.MapDiff que representa o resultado da comparação.

pegar

get(chave, valor_padrão) retorna valor

Retorna o valor associado a uma determinada sequência de chave de pesquisa.

Para mapas aninhados, envolvendo chaves e subchaves , retorna o valor associado a uma determinada sequência de subchaves. A subchave é identificada por meio de uma lista, cujo primeiro item é uma chave de nível superior e o último item é a subchave cujo valor deve ser consultado e retornado. Veja o exemplo de mapa aninhado abaixo.

A função requer um valor padrão para retornar se nenhuma correspondência com a chave de pesquisa fornecida for encontrada.

Parâmetro

chave

( regras.String não nulas ou regras.List não nulas)

Uma chave especificada como uma 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

chaves() retorna regras.Lista

Obtenha a lista de chaves no mapa.

Devoluções

non-null rules.List Lista lista de chaves.

tamanho

size() retorna regras.Integer

Obtenha o número de entradas no mapa.

Devoluções

non-null rules.Integer Número inteiro de entradas.

valores

valores() retorna regras.Lista

Obtenha a lista de valores no mapa.

Devoluções

non-null rules.List Lista lista de valores.