values

Valores guardados em um containers.Map ou dictionary.

Categoria: Language Fundamentals > Data Types

Sintaxe

v = values(M)

Retorna todos os valores, ordenados pela chave.

v = values(M, keys)

Retorna apenas os valores das chaves dadas, em um cell array.

Descrição

Um mapa mantém suas chaves ordenadas, então values(M) segue a ordem de keys(M): o primeiro valor pertence à primeira chave, e assim por diante. Esse pareamento facilita percorrer os dois juntos ou converter um mapa em tabela.

Para ler um único valor, indexar com a chave, M('a'), é mais simples.

Argumentos de entrada

M
Objeto containers.Map ou dictionary.
keys
Cell array de chaves a consultar. Uma chave inexistente gera erro.

Argumentos de saída

v
Para um containers.Map, um cell array 1-por-N; para um dictionary, um array do tipo dos valores.

Exemplo

Todos os valores e alguns selecionados

m = containers.Map({'a','b'}, [1 2]);
values(m)
values(m, {'b'})
Saída
ans = 1×2 cell

    {[1]}    {[2]}
ans = 1×1 cell

    {[2]}

Veja também

keys isKey remove containers.Map dictionary