11.5 Списки возвращаемых значений переменной длины

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

В качестве примера, следующая функция устанавливает первый выходной аргумент в 1, второй — в 2, и так далее.

function varargout = one_to_n ()
  for i = 1:nargout
    varargout{i} = i;
  endfor
endfunction

При вызове эта функция возвращает значения следующим образом

[a, b, c] = one_to_n ()
     ⇒ a =  1
     ⇒ b =  2
     ⇒ c =  3

Если varargin (varargout) не появляется в качестве последнего элемента списка входных (выходных) параметров, то он не является специальным и обрабатывается так же, как и любое другое имя параметра.

: [r1, r2, …, rn] = deal (a)

: [r1, r2, …, rn] = deal (a1, a2, …, an)

Копирует входные параметры в соответствующие выходные параметры.

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

Например,

[a, b, c] = deal (x, y, z);

эквивалентно

a = x;
b = y;
c = z;

и

[a, b, c] = deal (x);

эквивалентно

a = b = c = x;

Примечание по программированию: deal часто используется со списками, разделенными запятыми, полученными из массивов ячеек или структур. Это не нужно, так как интерпретатор может выполнить то же действие без накладных расходов вызова функции. Например:

c = {[1 2], "Three", 4};
[x, y, z] = c{:}
⇒
   x =

      1   2

   y = Three
   z =  4

См. также: cell2struct, struct2cell, repmat.