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.