mustBeNonzeroLengthText

验证值为非零长度的文本

自 R2020b 起

语法

mustBeNonzeroLengthText(value)

如果 value 在每个元素中没有至少一个字符，或如果输入不是文本，则 mustBeNonzeroLengthText(value) 会引发错误。此函数不返回值。

创建一个名为 txt 的空字符串。以 txt 作为输入，调用 mustBeNonzeroLengthText。mustBeNonzeroLengthText 会引发错误，因为该变量是一段长度为零的文本。

txt = "";
mustBeNonzeroLengthText(txt)

Value must be text with one or more characters.

使用 mustBeNonzeroLengthText 来限制函数接受的输入参数值。您可以通过向验证输入参数的函数添加参数代码块来实现这一点

此函数将参数 nonzeroLengthText 的值限制为非零长度文本值。

function MyFunction(nonzeroLengthText)
   arguments
      nonzeroLengthText {mustBeNonzeroLengthText}
   end
end

调用该函数。MATLAB^® 对分配给参数的值调用 mustBeNonzeroLengthText。mustBeNonzeroLengthText 会发出错误，因为值 "" 不是包含一个或多个字符的文本。

MyFunction("")

Error using MyFunction
 MyFunction("")
            ↑
Invalid argument at position 1. Value must be text with one or more characters.

要验证的值，指定为标量或数组。如果 value 不是每个元素中有至少一个字符的字符串数组、字符数组或字符向量元胞数组，则 nonzeroLengthText 将引发错误。

示例： nonzeroLengthText('foo')

在 R2020b 中推出