Campus Livre
remove
Apaga uma entrada de um dictionary ou de um containers.Map pela chave.
Categoria: Language Fundamentals > Data Types
Sintaxe
D = remove(D, key)Retorna o dictionary D sem a entrada de key.
remove(M, key)Apaga key do containers.Map M, no próprio objeto.
Descrição
Um dictionary se comporta como um valor comum, então remove retorna um novo dictionary e o original não muda até você atribuir o resultado. Um containers.Map é um objeto handle: remove altera o próprio mapa.
Pedir para remover uma chave que não existe é erro nos dois tipos; teste com isKey antes se a chave puder faltar.
Argumentos de entrada
D / M- Um objeto
dictionaryoucontainers.Map. key- Uma chave, ou um array de chaves, a apagar.
Argumentos de saída
D- O dictionary atualizado. Dictionaries são valores, então o resultado precisa ser atribuído.
Exemplo
d = dictionary(["a" "b"], [1 2]);
d = remove(d, "a")
m = containers.Map({'a','b'}, [1 2]);
remove(m, 'a');
m.keysSaída
d =
dictionary (string --> double) with 1 entry:
"b" --> 2
ans = 1×1 cell
{'b'}