`dictionary`

Tabela de consulta que associa chaves a valores.

Categoria: Language Fundamentals > Data Types

Sintaxe

d = dictionary()

Cria um dicionário vazio cujos tipos são definidos pela primeira entrada.

d = dictionary(keys, values)

Cria um dicionário a partir de arrays de chaves e valores.

d = dictionary(k1, v1, k2, v2, ...)

Cria a partir de pares chave e valor.

Descrição

Leia com d(chave) e escreva com d(chave) = valor; escrever numa chave existente troca o valor, e escrever numa chave nova adiciona uma entrada. Ler uma chave inexistente é erro, a menos que use lookup com valor reserva. Outras operações: isKey(d, k), keys(d), values(d), numEntries(d), remove(d, k) e entries(d).

Atribuir [] a uma chave, como em d("a") = [], a remove.

Argumentos de entrada

keys: Array de chaves únicas: números ou strings.
values: Array com um valor por chave, ou um cell array.

Argumentos de saída

d: Um dictionary. Diferente do containers.Map, é um objeto de valor, então uma cópia é independente do original.

Exemplo

Criar, consultar e atualizar

d = dictionary("a", 1, "b", 2);
d("c") = 3;
d("a")
isKey(d, ["a" "q"])
numEntries(d)
d

Saída

ans = 1
ans = 1×2 logical array

   1   0
ans = 3
d = 
  dictionary (string --> double) with 3 entries:

    "a" --> 1
    "b" --> 2
    "c" --> 3

Observações

remove gera erro quando a chave não existe, mesmo que FallbackValue seja passado.

Veja também

configureDictionary containers.Map entries isKey struct