matlab.lang.OnOffSwitchState class

Package: matlab.lang

Represent on and off states with logical values

Description

matlab.lang.OnOffSwitchState is an enumeration class that derives from the logical class. Use this class to implement properties that accept values of 'on' and 'off' and logical true, false, 1, or 0.

Use this class to constrain property values to any of these values:

Class	Logical True	Logical False
Character vector	`'on'`	`'off'`
String scalar	`"on"`	`"off"`
Logical	`true`	`false`
Logical and numeric	`1`	`0`
Enumeration member	`matlab.lang.OnOffSwitchState.on`	`matlab.lang.OnOffSwitchState.off`

Because OnOffSwitchState derives from the logical class, you can use these enumeration members in logical expressions.

Enumeration Members

`off`	Logical false
`on`	Logical true

Examples

collapse all

Enable Property Values to Be Logical or on/off

Use OnOffSwitchState to define the class of these properties.

classdef SystemState
   properties
      Power matlab.lang.OnOffSwitchState = 'off'
      Monitor matlab.lang.OnOffSwitchState = 'off'
   end
   methods
      function val = isOn(obj)
         if ~(obj.Power && obj.Monitor)
            val = matlab.lang.OnOffSwitchState.off;
         else
            val = matlab.lang.OnOffSwitchState.on;
         end
      end
   end
end

Create an object and set the property values to 'on'.

a = SystemState;
a.Power = 'on';
a.Monitor = 'on';

You can call the isOn method to determine the state of the system. The method returns a logical value provided by the OnOffSwitchState enumeration.

if isOn(a)
   ...% System is ready to use
end

More About

expand all

Specialized Concatenation Behavior

The OnOffSwitchState class supports special concatenation behavior to enable the formation of text expressions by concatenating enumeration members with character vectors or strings.

Normally, when forming an array by concatenating character vectors or strings with enumeration members, MATLAB^® attempts to convert the text to the class of the enumeration member. However, the OnOffSwitchState class defines specialized behavior that enables concatenation of enumeration members and text in cases where the text does not correspond to enumeration members defined by the class. In these cases, MATLAB creates an array of the same type as the text, as described in Concatenation Rules for OnOffSwitchState.

For example, if an object property named Power contains an enumeration member of the OnOffSwitchState class, you can form a character array with a character vector and the property value:

['The power switch is currently ' obj.Power]

Concatenation Rules for `OnOffSwitchState`

Here are the rules that MATLAB applies when concatenating character vectors or strings with enumeration members of the OnOffSwitchState class.

If all array elements are either OnOffSwitchState enumeration members or character vectors, all enumeration members are converted to their char equivalent representation. The resulting array is of type char.
If all array elements are either OnOffSwitchState enumeration members or strings, all enumeration members are converted to their string equivalent representation. The resulting array is of type string.
If all array elements are either OnOffSwitchState enumeration members, strings, or char vectors, all enumeration members and character vectors are converted to their string equivalent representation. The resulting array is of type string.
In all other cases, normal concatenation rules apply. For more information, see Concatenating Objects of Different Classes.

Testing for Equality

The OnOffSwitchState class supports the eq (==) and isequal functions for testing equality between enumeration members and char, string, logical, and numeric types having values of 1 or 0..

Documentation

matlab.lang.OnOffSwitchState class

Description

Enumeration Members

Examples

Enable Property Values to Be Logical or on/off

More About

Specialized Concatenation Behavior

Concatenation Rules for `OnOffSwitchState`

Testing for Equality

See Also

Topics

Introduced in R2017a

MATLAB Documentation

Support