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

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

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.