Main Content

mustBeVector

验证值为向量

自 R2020b 起

全页折叠

    语法

    mustBeVector(value)
    mustBeVector(value,"allow-all-empties")

    说明

    示例

    如果 value 不是向量，则 mustBeVector(value) 会引发错误。向量的维度为 1×n 或 n×1。此函数不返回值。

    如果 value 不是向量或空数组，则 mustBeVector(value,"allow-all-empties") 会引发错误。

    mustBeVector 调用以下函数来确定输入是否为向量：

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

    示例

    全部折叠

    确定值是否为行向量或列向量。

    a = rand(2);
mustBeVector(a)
    Value must be a 1-by-n vector or an n-by-1 vector.

    mustBeVector 会引发错误，因为输入是 2×2 数组。

    将值 a 重构为行向量。

    b = reshape(a,[1,numel(a)])
mustBeVector(b)

    mustBeVector 执行时不会引发错误或返回值。

    使用参量代码块将函数输入限制为使用 mustBeVector 和 mustBeNumeric 的数值向量。使用 mustBeVector allow-all-empties 选项允许空值。

    WeeklyTotals 函数对输入向量的元素求和。如果输入为空 ([])，返回的和为零。

    function r = WeeklyTotals(DailyTotals)
    arguments
        DailyTotals {mustBeVector(DailyTotals,'allow-all-empties'), mustBeNumeric}
    end
    if isempty(DailyTotals)
        r = 0;
    else
        r = sum(DailyTotals);
    end
end

    允许向函数传递空值。

    r = WeeklyTotals([])
    r = 
    0

    输入参数

    全部折叠

    要验证的值，指定为行向量或列向量。

    提示

    • mustBeVector 用于属性和函数参量验证。

    扩展功能

    C/C++ 代码生成
    使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

    版本历史记录

    在 R2020b 中推出

    另请参阅

    |

    主题