`addpref`

Cria uma nova preferência; falha se ela já existir.

Categoria: Environment and Settings > System Commands

Sintaxe

addpref(group, pref, val)

Adiciona a preferência pref com valor val ao grupo group.

Descrição

addpref é a forma estrita de criar uma preferência: se o nome já existe no grupo, gera um erro em vez de sobrescrever. Use setpref quando quiser o comportamento de criar ou atualizar.

Argumentos de entrada

group: Nome do grupo; ele é criado se necessário.
pref: Nome da preferência.
val: Valor a armazenar, de qualquer tipo.

Exemplo

Criar e tentar de novo

addpref('demoapp', 'level', 1);
disp(getpref('demoapp', 'level'))
try
    addpref('demoapp', 'level', 2);
catch err
    disp(err.message)
end
rmpref('demoapp');

Saída

     1
A preference with that GROUP and NAME already exists.

Veja também

setpref getpref rmpref ispref