addpref

Add custom setting

collapse all in page

Syntax

addpref(group,pref,value)

Description

addpref(group,pref,value) creates the specified setting in the specified group and sets its value to value. If the specified setting exists, MATLAB® returns an error.

Settings are persistent and maintain their values between MATLAB sessions.

example

Examples

collapse all

Add a setting called version to the mytoolbox group of settings. Set the value of version to the cell array {'1.0','beta'}.

addpref('mytoolbox','version',{'1.0','beta'})

Add two settings to the mytoolbox group of settings and set their values.

addpref('mytoolbox',{'modifieddate','docpath'},{'1/9/2019','C:\mytoolbox\documentation'})

Input Arguments

collapse all

Setting group name, specified as a character vector or a string scalar. group must be a valid variable name. For more information, see Variable Names.

Example: 'mytoolbox'

Data Types: char | string

Custom setting name, specified as a character vector, a cell array of character vectors, or a string array. pref must be a valid variable name. For more information, see Variable Names.

If pref is a cell array of character vectors or a non-scalar string, value must specify a value for each setting specified in pref.

Example: 'version'

Example: {'version','modifieddate','docpath'}

Data Types: char | string

Custom setting value, specified as any MATLAB data type, including numeric types, character vectors, cell arrays, structures, and objects. If pref is a cell array of character vectors or a nonscalar string array, value must specify a cell array that includes a value for each setting specified in pref.

Example: 1.1

Example: {{1.1,'beta'},datetime(2018,1,9),'C:\mytoolbox\documentation'}

Version History

Introduced before R2006a

expand all

See Also

Functions

Tools