11.6 Списки аргументов переменной длины ¶

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

a = smallest (1, 2, 3);
b = smallest (1, 2, 3, 4);

В этом примере оба a и b будут равны 1. Один из способов написания функции smallest —

function val = smallest (arg1, arg2, arg3, arg4, arg5)
  body
endfunction

а затем использовать значение nargin для определения, какие входные аргументы следует учитывать. Проблема этого подхода заключается в том, что он может обрабатывать только ограниченное количество входных аргументов.

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

function val = smallest (varargin)
  body
endfunction

В теле функции входные аргументы можно получить через переменную varargin. Эта переменная — ячейковый массив, содержащий все входные аргументы. Подробности работы с ячейковыми массивами см. в разделе Ячейковые массивы. Теперь функцию smallest можно определить следующим образом

function val = smallest (varargin)
  val = min ([varargin{:}]);
endfunction

Это реализация обрабатывает любое количество входных аргументов, но это также очень простое решение проблемы.

Более сложный пример использования varargin — функция print_arguments, которая выводит все входные аргументы. Такую функцию можно определить так

function print_arguments (varargin)
  for i = 1:length (varargin)
    printf ("Input argument %d: ", i);
    disp (varargin{i});
  endfor
endfunction

Эта функция выводит вывод, подобный этому

print_arguments (1, "two", 3);
     -| Input argument 1:  1
     -| Input argument 2: two
     -| Input argument 3:  3

: [reg, prop] = parseparams (params) ¶

: [reg, var1, …] = parseparams (params, name1, default1, …) ¶

Возвращает в reg элементы ячейки param до первого строкового элемента и в prop все оставшиеся элементы, начиная с первого строкового элемента.

Например:

[reg, prop] = parseparams ({1, 2, "linewidth", 10})
reg =
{
  [1,1] = 1
  [1,2] = 2
}
prop =
{
  [1,1] = linewidth
  [1,2] = 10
}

Функция parseparams может использоваться для разделения обычных числовых аргументов от дополнительных аргументов, заданных в виде пар «свойство-значение» в ячейковом массиве varargin.

Во второй форме вызова доступные варианты задаются непосредственно с их значениями по умолчанию, заданными в виде пар «имя-значение». Если params не образуют пары «имя-значение» или если встречается опция, не соответствующая ни одному из доступных вариантов, возникает ошибка.

При вызове из функции m-файла ошибка предваряется именем вызывающей функции.

Сопоставление опций выполняется без учета регистра.

См. также: varargin, inputParser.