Oct文件中的结构体 (GNU Octave(版本11.1.0))

下一个：Oct文件中的稀疏矩阵，前一个：Oct文件中的元胞数组，上级：Oct文件 [目录][索引]

A.1.5 Oct文件中的结构体¶

Octave 中的结构体是所表示的多个字段及其值之间的映射。它使用了标准模板库的 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 方法更加便捷。