Exponenta Banner
exponenta event banner

mustBeTextScalar

Проверить, что значение является одним фрагментом текста

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

Синтаксис

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

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

Поддержка