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 || nargin > 2)
    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.