`containers.Map`

Objeto de mapeamento que guarda valores associados a chaves de texto ou número.

Categoria: Language Fundamentals > Data Types

Sintaxe

M = containers.Map()

Cria um mapa vazio com chaves de caracteres e valores quaisquer.

M = containers.Map(keys, values)

Cria um mapa a partir de um cell array de chaves e valores correspondentes.

M = containers.Map('KeyType', kt, 'ValueType', vt)

Cria um mapa vazio com os tipos de chave e valor dados.

Descrição

Um mapa é um objeto handle: atribuí-lo a outra variável não o copia. Leia com M(chave) e escreva com M(chave) = valor; ler uma chave inexistente é erro. isKey(M, chave), keys(M), values(M), remove(M, chave) e a propriedade M.Count gerenciam o conteúdo.

As chaves ficam sempre em ordem, então keys(M) é alfabético para chaves de texto.

Argumentos de entrada

keys: Cell array de chaves (todas texto ou todas numéricas), ou uma chave.
values: Cell array ou array numérico de valores, na mesma quantidade das chaves.
'KeyType': 'char' (padrão), 'double', 'single', 'int32', 'uint32' etc.
'ValueType': 'any' (padrão), 'double', 'char', 'logical' etc.

Argumentos de saída

M: Um handle para o objeto de mapeamento.

Exemplo

Criar, ler e consultar

m = containers.Map({'a','b'}, [10 20]);
m('c') = 30;
m('b')
isKey(m, 'z')
m.keys
m.Count

Saída

ans = 20
ans = logical
   0
ans = 1×3 cell

    {'a'}    {'b'}    {'c'}
ans = uint64
   3

Veja também

dictionary isKey keys values struct