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

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

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

Функции

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

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

Валидация атрибута числового значения

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Подтвердите то значение, вектор

Член и валидация области значений

mustBeMemberПодтвердите, что значение - элемент заданного множества
mustBeInRangeПодтвердите то значение, находится в заданной области

Текст с валидацией особого значения

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

Темы

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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