`isKey`

Testa se chaves estão presentes em um containers.Map ou dictionary.

Categoria: Language Fundamentals > Data Types

Sintaxe

tf = isKey(M, key)

Retorna true se key é uma chave do mapa M.

tf = isKey(M, keys)

Com um cell array de chaves, testa cada uma e retorna um array lógico do mesmo tamanho.

Descrição

isKey é o modo seguro de proteger uma consulta, porque ler uma chave inexistente com M(key) gera erro. Chaves de texto são comparadas com distinção entre maiúsculas e minúsculas.

Para um containers.Map escreve-se isKey(M, key); para um dictionary a mesma função vale e M.isKey(key) também é aceito.

Argumentos de entrada

M: Um objeto containers.Map ou dictionary.
key, keys: Uma chave, ou um cell array de chaves. O tipo deve combinar com o tipo de chave do mapa.

Argumentos de saída

tf: Escalar lógico, ou array do tamanho do cell array keys.

Exemplo

Protegendo uma consulta

m = containers.Map({'a','b'}, [1 2]);
isKey(m, 'a')
isKey(m, {'a','z'})
if isKey(m, 'b'), disp(m('b')), end

Saída

ans = logical
   1
ans = 1×2 logical array

   1   0
     2

Veja também

keys values containers.Map remove