addSetting

Create a settings group and add a new setting to the group. Use the value of the setting in your code.

Create the settings group mysettings.

s = settings;
addGroup(s,"mysettings");

Add the setting MyWorkAddress to mysettings and assign it a value.

addSetting(s.mysettings,"MyWorkAddress");
s.mysettings.MyWorkAddress.PersonalValue = "3 Apple Hill Drive";
s.mysettings.MyWorkAddress

ans = 
  Setting 'mysettings.MyWorkAddress' with properties:

          ActiveValue: "3 Apple Hill Drive"
       TemporaryValue: <no value>
        PersonalValue: "3 Apple Hill Drive"
    InstallationValue: <no value>
         FactoryValue: <no value>

Display the value of the setting.

fprintf("Work address: %s.\n", s.mysettings.MyWorkAddress.ActiveValue)

Work address: 3 Apple Hill Drive.

Use removeGroup to remove mysettings.

removeGroup(s,"mysettings");

Use the settings function to access the root of the settings tree. Create a settings group, add a new hidden setting to the group, and use the value of the setting in your code.

Create the hidden settings group myhiddensettings.

s = settings;
newHiddenGroup = addGroup(s,"myhiddensettings",Hidden=true);

Add the setting MyHiddenWorkAddress to myhiddensettings and give it a value. Notice that the new setting does not appear when you display the parent settings group.

addSetting(newHiddenGroup,"MyHiddenWorkAddress",Hidden=true, ...
    PersonalValue="1 Lakeside Campus Drive");
s.myhiddensettings

ans = 
  SettingsGroup 'myhiddensettings' with no properties.

Display the value of the hidden setting.

fprintf("Work address: %s.\n", newHiddenGroup.MyHiddenWorkAddress.ActiveValue)

Work address: 1 Lakeside Campus Drive.

You can remove the hidden group in the same way you would a visible group.

removeGroup(s,"myhiddensettings")

Create a settings group and specify a default validation function for the group. This function validates the values of all settings within the group that do not have their own validation functions defined.

Create a validation function numericValidationFcn that throws an error when the input is not numeric.

function numericValidationFcn(x)
    errorMsg = "Value must be numeric."; 
    assert(isnumeric(x),errorMsg);
end

Use the settings function to access the root of the settings tree and then create the settings group myNumericSettings. Specify the validation function.

s = settings;
newNumericGroup = addGroup(s,"myNumericSettings",...
    ValidationFcn=@numericValidationFcn);

If you create a new setting in the myNumericSettings group and attempt to set the value of the setting to a nonnumeric value, MATLAB errors. For example, MATLAB errors if you run this statement, which attempts to set PersonalValue to a string instead of a numeric value.

addSetting(newNumericGroup,"mySetting",PersonalValue="Hello")

Use removeGroup to remove myNumericSettings.

removeGroup(s,"myNumericSettings");