Аргументы ввода и вывода

Поддержите списки аргументов переменной длины, проверяйте аргументы, объявите аргументы для валидации

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

Функции

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

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

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

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

Функции валидации

mustBeFiniteПодтвердите, что значение конечно, или выдайте ошибку
mustBeGreaterThanПодтвердите, что значение больше, чем другое значение, или выдайте ошибку
mustBeGreaterThanOrEqualПодтвердите, что значение больше, чем или равно другому значению, или выдайте ошибку
mustBeIntegerПодтвердите то значение, целое число, или выдать ошибку
mustBeLessThanПодтвердите, что значение, меньше, чем другое значение, или выдайте ошибку
mustBeLessThanOrEqualПодтвердите, что значение меньше чем или равно другому значению, или выдайте ошибку
mustBeMemberПодтвердите, что значение - элемент заданного множества
mustBeNegativeПодтвердите, что значение отрицательно, или выдайте ошибку
mustBeNonemptyПодтвердите, что значение, непусто, или выдайте ошибку
mustBeNonNanПодтвердите, что значение равно nonNaN
mustBeNonnegativeПодтвердите, что значение является неотрицательным, или выдайте ошибку
mustBeNonpositiveПодтвердите, что значение неположительно или выдайте ошибку
mustBeNonsparseПодтвердите то значение, неразреженно, или выдать ошибку
mustBeNonzeroПодтвердите то значение, является ненулевым, или выдать ошибку
mustBeNumericПодтвердите то значение, является числовым, или выдать ошибку
mustBeNumericOrLogicalПодтвердите то значение, является числовым или логическим, или выдать ошибку
mustBePositiveПодтвердите то значение, положительно, или выдать ошибку
mustBeRealПодтвердите то значение, действительно, или выдать ошибку

Темы

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

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

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

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

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

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

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

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

Проверяйте, получает ли ваша пользовательская функция верный номер аргументов ввода или вывода. MATLAB выполняет некоторые проверки аргумента автоматически. Для других случаев можно использовать narginchk или nargoutchk.

Проверка аргументов во вложенных функциях

Существуют специальные замечания для использования vararginvarargoutnargin, и nargout с вложенными функциями.

Игнорирование входных параметров функции

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

Игнорирование функции Выходные параметры

В этом примере показано, как запросить определенные выходные параметры от функции.

Проанализируйте входные параметры

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

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

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

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

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

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

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

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