A.1.5 Структуры в файлах Oct

Структура в Octave представляет собой отображение между несколькими полями и их значениями. Используется класс Standard Template Library map, где пара состоит из std::string и переменной Octave Cell.

Простой пример демонстрации использования структур в файлах oct-файлов:

#include <octave/oct.h>
#include <octave/ov-struct.h>

DEFUN_DLD (structdemo, args, , "Struct Demo")
{
  if (args.length () != 2)
    print_usage ();

  if (! args(0).isstruct ())
    error ("structdemo: ARG1 must be a struct");

  octave_scalar_map arg0 = args(0).scalar_map_value ();
  //octave_map arg0 = args(0).map_value ();

  if (! args(1).is_string ())
    error ("structdemo: ARG2 must be a character string");

  std::string arg1 = args(1).string_value ();

  octave_value tmp = arg0.contents (arg1);
  //octave_value tmp = arg0.contents (arg1)(0);

  if (! tmp.is_defined ())
    error ("structdemo: struct does not have a field named '%s'\n",
           arg1.c_str ());

  octave_scalar_map st;

  st.assign ("selected", tmp);

  return octave_value (st);
}

Пример его использования:

x.a = 1; x.b = "test"; x.c = [1, 2];
structdemo (x, "b")
⇒ selected = test

В приведенном выше примере конкретно используется класс octave_scalar_map, предназначенный для представления одной структуры. Для массивов структур используется класс octave_map. Комментированный код показывает, как можно модифицировать демонстрацию для обработки массива структур. В этом случае метод contents возвращает Cell, который может содержать более одного элемента. Поэтому, чтобы получить базовую octave_value в примере с одной структурой, мы бы написали:

octave_value tmp = arg0.contents (arg1)(0);

где заключительный (0) — оператор () над объектом Cell. Если это был бы настоящий массив структур с несколькими элементами, мы могли бы перебирать элементы, используя оператор ().

Структуры — это относительно сложные контейнеры данных, и в oct-map.h доступно больше функций, которые облегчают работу с ними по сравнению с использованием только contents.