如何为双指针结构参数

时间:2016-03-23 17:03:09

标签: python c pointers swig

我有一个API,我试图使用SWIG包装,以便我可以从python调用底层的C库。

我遇到了特定的API fn:

int update_tracks(track_t **phash_tracks,
                  const pdws_t *pdw_frame,
                  const rdws_t *rdw_frame,
                  lib_t *lib,
                  lib_meta_t *lib_meta,
                  const cfg_t *cfg);

它是track_t数据结构的双指针,我无法处理。

所有单指针都能正常工作。

这是唯一具有指向track_t

的双指针的API fn

所有其他人只有一个指针,例如

void print_hash_tracks(const track_t *hash_tracks, const cfg_t *cfg,
                       enum TRKTYPE trktype);

我非常确定我需要在SWIG界面文件(interface.i)中创建一个类型图,但我发现SWIG文档难以理解。

我认为我需要做的是创建一个类型图,每当它看到track_t**类型时,它需要track_t*并将其转换为其地址,如:

/* provide typemap to handle instances of track_t** parameters */
%typemap(in) track_t** (track_t *tracks) {
    $1 = &tracks;
}

但我在运行时遇到了分段错误:

tracks = g3.track_t()
g3.update_tracks(tracks, pdw_frame, rdw_frame, lib, lib_meta, cfg)

在python方面。

我觉得我几乎已经解决了这个问题,但是不能正确地获得类型图规范,同时也很难理解相关文档。

柔印 - 如果你在那里 - 也许你可以对此有所了解,你似乎是这方面的SO专家..

更新 - m7ython(太棒了!另一位SW上的SOIG专家)

C中的用法非常简单

声明并初始化一个指向NULL的track_t指针:

track_t *hash_tracks = NULL;

然后:

update_tracks(&hash_tracks, &pdw_frame, &rdw_frame,
              &lib, &lib_meta, &cfg);

因此指向track_t的指针的地址作为arg传递给update_tracks()update_tracks() fn处理放入hash_tracks的数据的所有必要malloc,即track_t结构的哈希表

所有其他args都是单指针,我可以在python端创建并填充它们没有任何问题。

track_t是一个包含一堆整数,浮点数,字符*等的结构,例如

typedef struct
{
/* make struct hashable */
UT_hash_handle hh;

int id;
...
char name[MAX_BUF];
...
} track_t;

track_t arg是track_t**而不仅仅是track_t*的原因是因为hash_tracks是指向哈希表的指针(使用UTHash库)。 hash_tracks指向哈希表中的第一个track_t。在update_tracks() fn track_t的主体中,可以在哈希表中添加/删除结构,这样指向第一个track_t的指针可能会发生变化,即hash_tracks可能在调用{之后指向其他内容{1}},因此将指针传递给指针的原因。

换句话说,update_tracks() arg,track_t**被用作输入和输出类型arg,因此指向指针。所有其他args只是输入,它们不会改变,所以它们可以作为单个指针传入。

我试图帮助fn'具有以下C fn的路线:

phash_tracks

使用calloc应确保* phash_tracks为NULL

这个编译和包装没有任何错误,但是当我从python一侧使用它时,它会被分段,例如。

track_t** make_phash_tracks(void)
{
    track_t **phash_tracks;

    phash_tracks = calloc(1, sizeof(track_t*));

    return phash_tracks;
}

在调用phash_tracks = g3.make_phash_tracks() g3.update_tracks(phash_tracks, pdw_frame, rdw_frame, lib, lib_meta, cfg) 之前检查phash_tracks var给出了:

update_tracks

1 个答案:

答案 0 :(得分:5)

编辑:好的,我想我现在明白了update_tracks的作用。看来你可以用两种方式使用这个功能。如果您将指针传递给tracks指针,则更新现有tracks或创建NULL。我不确定在SWIG中处理这两种情况的最优雅的方式(或者如果这甚至是一个问题),但这里有一些选项。

1。 phash_tracks是输出参数

首先,必须*phash_tracks传递回Python作为返回值,并以某种形式使用该函数,如

>>> int_res, tracks = g3.update_tracks(tracks, pdw_frame, rdw_frame, lib, lib_meta, cfg)

>>> int_res, tracks = g3.update_tracks(pdw_frame, rdw_frame, lib, lib_meta, cfg)

这是通过以下“argout”typemap来实现的:

%typemap(argout) track_t **phash_tracks {
  %append_output(SWIG_NewPointerObj(%as_voidptr(*$1), $*1_descriptor, SWIG_POINTER_OWN));
}

也许您不希望Python取得track_t*的所有权,然后将SWIG_POINTER_OWN替换为0

2。传递空phash_tracks

如果您只想使用update_tracks功能创建 tracks,您可以基本上完​​成您已经在做的事情。使用以下“in”typemap,并使用上面第二个示例中的函数(不带tracks参数)。

%typemap(in, numinputs=0) track_t **phash_tracks (track_t *tracks) {
  tracks = NULL;
  $1 = &tracks;
}

3。 phash_tracks作为输入(和输出)参数

如果您想使用update_tracks更新现有 tracks,您应该可以使用我之前建议的“in”类型映射,并使用Python中的函数与第一个示例中一样(包括tracks参数)。

%typemap(in) track_t **phash_tracks (track_t *tracks) {
  if ((SWIG_ConvertPtr($input, (void **) &tracks, $*1_descriptor, SWIG_POINTER_EXCEPTION | SWIG_POINTER_DISOWN)) == -1)
    return NULL;
  $1 = &tracks;
}

请注意,Python禁用其tracks_t*

非常重要

4。启用上面的(2)和(3)

如果你可以通过swig传递包裹的tracks NULL,你基本上也可以使用版本(3)来创建 tracks_t*。我不确定SWIG是否允许这样做 - 但也许确实如此。尝试使用辅助函数:

tracks_t* empty_tracks() { return NULL; }

或者,您可以沿着以下行修改“in”类型映射,尝试将提供的参数转换为track_t*并传递其地址,或者传递NULL {{的地址1}}。

track_t*

然后,从Python中,只需传递其他内容即可创建%typemap(in) track_t **phash_tracks (track_t *tracks) { // Alternatively, check if $input is a 0 integer `PyObject`... if ((SWIG_ConvertPtr($input, (void **) &tracks, $*1_descriptor, SWIG_POINTER_DISOWN)) == -1) tracks = NULL; $1 = &tracks; }

tracks