exponenta event banner

Определения аргументов

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

Поскольку MATLAB ® является нетипизированным языком, большинство функций не требуют объявления аргументов или проверки. Однако, если функция широко используется и необходимо проверить тип, размер или другие аспекты входных данных, чтобы убедиться, что код работает так, как ожидалось, можно определить arguments блок (с R2019b). Дополнительные сведения см. в разделе Проверка аргументов функции.

Кроме того, можно проверить, сколько входов или выходов получает функция, имена входных переменных и многое другое.

Функции

развернуть все

Блок аргументов

argumentsОбъявить проверку аргумента функции

Проверка числового значения

mustBePositiveПроверить положительное значение
mustBeNonpositiveПроверить, что значение не является положительным
mustBeNonnegativeПроверить, что значение не является отрицательным
mustBeNegativeПроверить отрицательное значение
mustBeFiniteПроверить конечное значение
mustBeNonNanПроверьте, что значение не равно NaN
mustBeNonzeroПроверить, что значение не равно нулю
mustBeNonsparseПроверить, что значение не разобрано
mustBeRealПроверить, что значение является реальным
mustBeIntegerПроверить, что значение целое
mustBeNonmissingПроверить, что значение не отсутствует

Сравнения

mustBeGreaterThanПроверить, что значение больше другого значения
mustBeLessThanПроверить, что значение меньше другого значения
mustBeGreaterThanOrEqualПроверить, что значение больше или равно другому значению
mustBeLessThanOrEqualПроверить, что значение меньше или равно другому значению

Типы данных

mustBeAПроверить, что значение получено из одного из указанных классов
mustBeNumericПроверить числовое значение
mustBeNumericOrLogicalПроверка числового или логического значения
mustBeFloatПроверьте, является ли значение массивом с плавающей запятой
mustBeTextПроверьте, является ли значение строковым массивом, символьным вектором или массивом ячеек символьных векторов
mustBeTextScalarПроверить, что значение является одним фрагментом текста
mustBeNonzeroLengthTextПроверить, что это текст с ненулевой длиной
mustBeUnderlyingTypeПроверить, что значение имеет указанный базовый тип

Размер

mustBeNonemptyПроверка непустого значения
mustBeScalarOrEmptyПроверка скаляра или пустого значения
mustBeVectorПроверить, что значение является векторным

Диапазон и набор участников

mustBeInRangeПроверить, что значение находится в указанном диапазоне
mustBeMemberПроверить, что значение является членом указанного набора

Имена

mustBeFileПроверить, что путь ссылается на файл
mustBeFolderПроверить, что путь ввода ссылается на папку
mustBeValidVariableNameУбедитесь, что входное имя является допустимым именем переменной

Структура аргументов «имя-значение»

namedargs2cellПреобразование структуры, содержащей пары имя-значение, в массив ячеек

Исходные данные

vararginСписок входных аргументов переменной длины
narginКоличество входных аргументов функции
narginchkПроверка количества входных аргументов

Продукция

varargoutСписок выходных аргументов переменной длины
nargoutКоличество выходных аргументов функции
nargoutchkПроверка количества выходных аргументов
validateattributesПроверка достоверности массива
validatestringПроверка достоверности текста
validatecolorПроверка значений цвета
inputnameИмя переменной ввода функции
mfilenameИмя файла текущего кода
inputParserВходной синтаксический анализатор для функций

Темы

Значения аргументов

Способы анализа входных данных функций

Выберите метод проверки достоверности входных аргументов.

Проверка аргумента функции

Объявить класс и размер входного аргумента и применить ограничения к значениям аргумента.

Проверка входов функций с помощью атрибутов validateatributes

В этом примере показано, как проверить соответствие входных данных функции набору требований с помощью validateattributes функция.

Входы функции синтаксического анализа

Определите требуемые и необязательные входы, назначьте значения по умолчанию дополнительным входам и проверьте все входы пользовательской функции с помощью анализатора входов.

Количество аргументов

Поддерживаемое переменное количество входов

Определение функции, которая принимает переменное число входных аргументов с помощью varargin. varargin аргумент - это массив ячеек, содержащий входы функций, где каждый вход находится в собственной ячейке.

Поддерживаемое переменное количество выходов

Определение функции, возвращающей переменное число выходных аргументов с помощью varargout. Продукция varargout - массив ячеек, содержащий выходные сигналы функции, где каждый выходной сигнал находится в собственной ячейке.

Найти число аргументов функции

Использовать nargin и nargout чтобы определить, сколько входных или выходных аргументов получает функция.

Проходные входы

Игнорировать входные данные в определениях функций

Если функция принимает предопределенный набор входов, но не использует все входы, используйте тильду (~), чтобы игнорировать их в определении функции.