mustBeTextScalar

Проверьте, что значение представляет собой одну часть текста

Синтаксис

Описание

пример

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

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

  • Для символьных массивов, одна часть текста является вектором-строкой, таким как ‘text’. Пустой массив char 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
Для просмотра документации необходимо авторизоваться на сайте