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
Invalid argument at position 1. Value must be a character vector or string scalar.

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

свернуть все

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

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

Введенный в R2020b