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

: isargout (k) ¶

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

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

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

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