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

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

Начиная с 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Подтвердите тот вход path, относится к папке
mustBeValidVariableNameПодтвердите то входное имя, допустимое имя переменной

Структура аргументов name-value

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

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

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

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

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

Темы

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

Пути к Анализу входных параметров функции

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

Валидация аргумента функции

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

Проверка Входных параметров функции с validateattributes

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

Анализ входных параметров функции

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

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

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

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

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

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

Определение количества аргументов функции

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

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

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

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