`getpref`

Lê uma preferência armazenada sob o nome de um grupo.

Categoria: Environment and Settings > System Commands

Sintaxe

v = getpref(group, pref)

Retorna o valor de pref em group; gera erro se não existir.

v = getpref(group, pref, default)

Retorna default quando a preferência não existe.

s = getpref(group)

Retorna uma struct com todas as preferências do grupo.

Descrição

Preferências são um pequeno armazenamento chave/valor para opções do usuário, organizado por grupo e nome. A forma de três argumentos com um valor padrão é o modo habitual de ler uma opção que pode ainda não ter sido salva.

Argumentos de entrada

group: Nome do grupo, normalmente o nome do programa dono das preferências.
pref: Nome da preferência.
default: Valor retornado no lugar de um erro quando a preferência não existe.

Argumentos de saída

v: O valor armazenado, de qualquer tipo; ou uma struct quando só group é informado.

Exemplo

Ler com valor padrão

setpref('demoapp', 'count', 7);
disp(getpref('demoapp', 'count'))
disp(getpref('demoapp', 'color', 'blue'))
s = getpref('demoapp')
rmpref('demoapp');

Saída

     7
blue
s = struct with fields:

    count: 7
    color: 'blue'

Veja também

setpref addpref rmpref ispref