11.7 Игнорирование аргументов

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

function val = pick2nd (~, arg2)
  val = arg2;
endfunction

Значение nargin не изменяется при использовании этого объявления.

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

x = [2, 3, 1];
[s, i] = sort (x)
⇒
s =

   1   2   3

i =

   3   1   2

[~, i] = sort (x)
⇒
i =

   3   1   2

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

[~ i] = sort (x)
parse error:

  invalid left hand side of assignment

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

function [out1, out2] = long_function (x, y, z)
  if (isargout (1))
    ## Long calculation
    …
    out1 = result;
  endif
  …
endfunction

: isargout (k)

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

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

Если k выходит за пределы диапазона 1:max (nargout), функция возвращает ложь. k также может быть массивом, в этом случае функция работает поэлементно и возвращает логический массив. На верхнем уровне isargout возвращает ошибку.

См. также: nargout, varargout, nthargout.