Documentation

setpref

Set preference

Syntax

setpref('group','pref',val)
setpref('group',{'pref1','pref2',...,'prefn'},{val1,val2,...,valn})

Description

setpref('group','pref',val) sets the preference specified by group and pref to the value val. Individual preference values can be any MATLAB® data type, including numeric types, strings, cell arrays, structures, and objects. Setting a preference that does not yet exist causes it to be created.

group labels a related collection of preferences. You can choose any name that is a legal variable name, and is descriptive enough to be unique, e.g., 'MathWorks_GUIDE_ApplicationPrefs'. The input argument pref identifies an individual preference in that group, and must be a legal variable name.

setpref('group',{'pref1','pref2',...,'prefn'},{val1,val2,...,valn}) sets each preference specified in the cell array of names to the corresponding value.

    Note   Preference values are persistent and maintain their values between MATLAB sessions. Where they are stored is system dependent.

Examples

Use addpref to create a preference group called mytoolbox and a preference within it called version, and then modify the contents of version using setpref:

addpref('mytoolbox','version','1.0')
getpref('mytoolbox','version')

ans =
1.0

setpref('mytoolbox','version',{'1.0','beta'})
getpref('mytoolbox','version')

ans = 
    '1.0'    'beta'
Was this topic helpful?