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)
参考:
- 无