mustBeMember

验证值是指定集的成员

全页折叠

语法

mustBeMember(value,S)

说明

示例

如果 value 不是 S 指定的值集合的成员，mustBeMember(value,S) 将引发错误。value 指定的值集合必须是区分大小写的精确匹配。mustBeMember 不返回值。

将 mustBeMember 用作属性或函数参数验证函数时，请确保属性的默认值是集合的成员。

mustBeMember 调用以下函数来确定 value 是否为 S 指定的值集合的成员。

ismember

支持的类：重载 ismember 的所有数值类、logical、char 和 MATLAB^® 类。

示例

全部折叠

验证第一个输入是集合的成员

使用 mustBeMember 验证第一个输入是第二个输入指定的值集合的成员。

验证字符向量 'red' 是字符向量 'yellow'、'green' 和 'blue' 集合的成员。

A = 'red';
B = {'yellow','green','blue'};
mustBeMember(A,B)

Value must be a member of this set
    'yellow'
    'green'
    'blue'

验证失败，因为 'red' 不是集合的成员。MATLAB 返回列出允许值的错误消息。

限制属性值

此类将属性的值限制为一组特定的值。

Prop1 的值必须为 'yellow'、'green' 或 'blue'。

classdef MyClass
   properties
      Prop1 {mustBeMember(Prop1,{'yellow','green','blue'})} = 'yellow'
   end
end

默认属性值必须符合验证函数所施加的限制。因此，必须为其显式指定一个属于集合成员的默认值。

创建一个对象，并向其属性赋值。

obj = MyClass
obj.Prop1 = 'red';

Error setting 'Prop1' property of 'MyClass' class. Value must be a member of this set
    'yellow'
    'green'
    'blue'

验证失败，因为 'red' 不是集合的成员。MATLAB 返回列出允许值的错误消息。

限制函数参数值

此函数声明两个输入参数。输入 n 必须为标量数值，输入 typename 必须为字符向量 single 或 double。

function r = mbMember(n,typename)
    arguments
        n (1,1) {mustBeNumeric}
        typename {mustBeMember(typename,{'single','double'})} = 'single'
    end
    r = rand(n,typename);
end

此函数调用使用的 typename 值不满足 mustBeMember 定义的要求，并会引发错误。

r = mbMember(5,'int32');

Error using mbMember
 r = mbMember(5,'int32');
                ↑
Invalid input argument at position 2. Value must be a member of this set:
    'single'
    'double'