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

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

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

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

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

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

: tf = isargout (k) ¶

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

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

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

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