34.2 Методы класса

Существует ряд основных методов класса, которые можно (и следует) определять, чтобы иметь возможность получать и задавать содержимое классов. Самый важный из них — метод disp. Метод disp используется Octave всякий раз, когда класс нужно вывести на экран. Обычно это происходит в результате вычисления выражения Octave, не заканчивающегося точкой с запятой. Если этот метод не определён, Octave ничего не выведет при отображении содержимого класса, что может вызвать недоумение.

Например, метод disp для класса полиномов может выглядеть так:

function disp (p)

  a = p.poly;
  first = true;
  for i = 1 : length (a);
    if (a(i) != 0)
      if (first)
        first = false;
      elseif (a(i) > 0 || isnan (a(i)))
        printf (" +");
      endif
      if (a(i) < 0)
        printf (" -");
      endif
      if (i == 1)
        printf (" %.5g", abs (a(i)));
      elseif (abs (a(i)) != 1)
        printf (" %.5g *", abs (a(i)));
      endif
      if (i > 1)
        printf (" X");
      endif
      if (i > 2)
        printf (" ^ %d", i - 1);
      endif
    endif
  endfor

  if (first)
    printf (" 0");
  endif
  printf ("\n");

endfunction

Для согласованности с классами графических дескрипторов Octave класс также должен определять методы get и set. Метод get принимает один или два аргумента. Первый аргумент — объект соответствующего класса. Если второй аргумент не указан, метод должен возвращать структуру со всеми свойствами класса. Если указан необязательный второй аргумент, он должен быть именем свойства, и метод должен возвращать значение указанного свойства.

function val = get (p, prop)

  if (nargin < 1)
    print_usage ();
  endif

  if (nargin == 1)
    val.poly = p.poly;
  else
    if (! ischar (prop))
      error ("@polynomial/get: PROPERTY must be a string");
    endif

    switch (prop)
      case "poly"
        val = p.poly;
      otherwise
        error ('@polynomial/get: invalid PROPERTY "%s"', prop);
    endswitch
  endif

endfunction

Аналогично, первым аргументом метода set должен быть объект, а дополнительные аргументы должны представлять собой пары «свойство/значение».

function pout = set (p, varargin)

  if (numel (varargin) < 2 || rem (numel (varargin), 2) != 0)
    error ("@polynomial/set: expecting PROPERTY/VALUE pairs");
  endif

  pout = p;
  while (numel (varargin) > 1)
    prop = varargin{1};
    val  = varargin{2};
    varargin(1:2) = [];
    if (! ischar (prop) || ! strcmp (prop, "poly"))
      error ("@polynomial/set: invalid PROPERTY for polynomial class");
    elseif (! (isreal (val) && isvector (val)))
      error ("@polynomial/set: VALUE must be a real vector");
    endif

    pout.poly = val(:).';  # force row vector
  endwhile

endfunction

Обратите внимание, что в Octave не реализована передача по ссылке; поэтому для изменения объекта требуется оператор присваивания, использующий возвращаемое значение метода set.

p = set (p, "poly", [1, 0, 0, 0, 1]);

Метод set использует метод subsasgn класса, поэтому этот метод также должен быть определён. Метод subsasgn подробнее рассматривается в следующем разделе (см. Индексация объектов).

Наконец, пользовательские классы можно рассматривать как особый тип структуры, и их можно сохранять в файл так же, как структуры. Например:

p = polynomial ([1, 0, 1]);
save userclass.mat p
clear p
load userclass.mat

Поддерживаются все форматы файлов, поддерживаемые save и load. В некоторых случаях пользовательский класс может содержать поле, которое не имеет смысла сохранять, или поле, которое необходимо инициализировать перед сохранением. Для этого можно использовать метод saveobj класса.

: b = saveobj (a)

Метод класса для обработки объекта перед сохранением его в файл.

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

function b = saveobj (a)
  b = a;
  if (isempty (b.field))
     b.field = initfield (b);
  endif
endfunction

См. также: loadobj, class.

saveobj вызывается непосредственно перед сохранением класса в файл. Аналогично, метод loadobj вызывается сразу после загрузки класса из файла и может использоваться для восстановления в пользовательском объекте удалённых полей.

: b = loadobj (a)

Метод класса для обработки объекта после его загрузки из файла.

Функция loadobj вызывается, когда объект a загружается с помощью функции load. Например, saveobj можно использовать для добавления к объекту полей, которые не имеет смысла сохранять. Например:

function b = loadobj (a)
  b = a;
  b.addmissingfield = addfield (b);
endfunction

См. также: saveobj, class.