prg_list_strings_append()

摘要

向指定列表追加一组字符串。

语法

prg_list_strings_append (list_ptr)
参数 类型 说明
listptr PrgT_List* 指向目标列表的指针
<string list> char * 以逗号分隔的字符串常量或变量列表
这个由一个或多个参数组成的列表必须以符号常量 PRGC_NIL 结尾。

返回类型

void

无返回值

头文件

prg_list_funcs.h

示例:

/* create a textlist to be used for setting an Ema object value.*/
lptr [0] = prg_list_create ();
lptr [1] = prg_list_create();

prg_list_strings_append (lptr [1], “custom_model_list”, “general”, PRGC_NIL);

Ema_Model_Attr_Set (model_id, “ext fileset”, COMP_CONTENTS, lptr[0],
	“keywords list”, COMP_CONTENTS, lptr[1],
	EMAC_EOL);

详情

可以向指定列表追加任意数目的字符串。字符串参数必须以 PRGC_NIL 常量结尾。

对于要追加到列表的每个字符串,此函数会先创建该字符串的一个新分配副本,再将其加入列表。因此,在不再需要时,必须同时释放字符串列表元素和列表本身。

**警告:**该函数 MT 不安全(线程不安全),相关说明见“Multi-Threading Safety“ 第 11 页。对共享列表的访问必须由外部串行化。

用途:

此函数提供了一种向列表追加字符串的机制。

错误:

  • 程序中止:段错误(由于畸形或无效的列表,或最后一个参数缺少 PRGC_NIL)

参考:

  • 无

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com