Exponenta Banner
exponenta event banner

mustBeTextScalar

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

Свернуть все на странице

Синтаксис

mustBeTextScalar(value)

Описание

пример

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

Документация MATLAB

Поддержка