exponenta event banner

mustBeTextScalar

Подтвердите то значение, одна часть текста

Синтаксис

Описание

пример

mustBeTextScalar(value) выдает ошибку если value не текстовый скаляр. Текстовый скаляр является одной частью текста, но определение варьируется типом данных:

  • Для строковых массивов одна часть текста является скаляром 1 на 1, таким как “text”. Пустая строка "" и отсутствующие строки являются особыми случаями, которые также рассчитывают как одна части текста.

  • Для символьных массивов одна часть текста является вектором-строкой, таким как ‘text’. Пустой массив символов 0 на 0 '' особый случай, который также рассчитывает как одна часть текста

Эта функция не возвращает значение.

Примеры

свернуть все

Создайте массив строк под названием text, и затем используйте mustBeTextScalar подтверждать значение. mustBeTextScalar выдает ошибку, поскольку переменная содержит несколько строк.

text = ["this" "will" "throw" "an" "error"];
mustBeTextScalar(text)
Value must be a character vector or string scalar.

Используйте mustBeTextScalar ограничить значения входного параметра, которые приняты функцией. Можно выполнить это путем добавления блока аргументов в функцию, которая подтверждает входные параметры

Эта функция ограничивает значение аргумента textScalarInput к текстовым значениям.

function MyFunction(textScalarInput)
   arguments
      textScalarInput {mustBeTextScalar}
   end
end

Вызовите функцию. MATLAB® вызовы mustBeTextScalar на значении, присваиваемом аргументу. mustBeTextScalar выдает ошибку потому что значение ["foo","bar"] не текстовый скаляр.

MyFunction(["foo","bar"])
Error using MyFunction
 MyFunction(["foo","bar"]);
            ↑
Invalid argument at position 1. Value must be a character vector or string scalar.

Входные параметры

свернуть все

Значение, чтобы подтвердить в виде скаляра или массива. Если value не 1 x 1 массив строк, "" или <missing> строка, символьный массив вектора-строки или '' mustBeTextScalar выдаст ошибку.

Пример: mustBeTextScalar('foo')

Введенный в R2020b