prg_str_decomp()

摘要

将由特定字符分隔字段组成的源字符串分解为字符串列表。

语法

prg_str_decomp (string, separators)
参数 类型 说明
string const char * 要分解为字段的源字符串 [该字符串应包含一系列字段,字段之间以 separators 参数中列出的任一分隔字符分隔。传入的字符串不受此函数影响。]
separators const char * 用于分隔源字符串字段的分隔字符 [该字符串应包含一组用作源字符串字段定界符的字符。常见选择包括竖线(“|”)、逗号(“,”)、句点(“.”)或分号(“;”)字符。

返回类型

PrgT_List *

指向从源字符串中提取出的字段列表(即字符串列表)的指针。该列表指针通常直接赋给声明为 PrgT_List* 的变量,如 Example 小节所示。即使列表中不含任何字段值,也会返回有效的列表指针。若发生可恢复错误,则返回 PRGC_NIL。

头文件

prg_string_funcs.h

示例

/* open and read in an address/stream translation table file */
table_list_ptr = prg_gdf_read ("addr_to_strm");

/* determine how many rows the table contains */
num_rows = prg_list_size (table_list_ptr);

/* loop through the table’s rows */
for (i = 0; i < num_rows; i++)
	{
	/* obtain a list of the columnar fields in each row */
	field_list_ptr = prg_str_decomp (prg_list_access (table_list_ptr, i), ":");

	/* extract the values of the two fields, and insert into the table matrix */
	trans_tab [i].address = atoi (prg_list_access (field_list_ptr, 0));
	trans_tab [i].stream = atoi (prg_list_access (field_list_ptr, 1));

	/* deallocate the field list contents and list */
	prg_list_free (field_list_ptr);
	prg_mem_free (field_list_ptr);
	}
/* deallocate the table list contents and list */
prg_list_free (table_list_ptr);
prg_mem_free (table_list_ptr);

详情

该函数动态分配返回的字段列表及其内容,且不影响传入的参数。因此可以按照调用方进程的需要对字段列表进行各种操作。列表完成用途之后,应通过 prg_list_free() 释放其内容,并通过 prg_mem_free() 释放列表本身,以便其内存可以被回收用于其他用途。

源字符串中的字段可以包含空白字符(即空格或制表符)以及除分隔符以外的任何字符。但第一个字段的开头空白会被移除,因此整组字段可以在源字符串中水平偏移而不影响字段内容。在准备字段列表时,完全由空白字符组成的字段不会被包含。例如,若源字符串由十个字段(#0–#9)组成,且字段 #4 全为空白,则返回的列表将由九个字符串组成:字段 #0 至 #3 以及字段 #5 至 #9。

位于一对单引号或双引号内的任何字符都会保留在同一字段中,即使引号内出现了定界符。若在定界字符串中遇到未配对单引号 (') 或双引号 ("),则字符串的剩余部分将作为一个字段插入字段列表。

若要改变提取过程中处理字符串的方式(例如保留开头空白或允许未配对的引号),请使用 prg_str_decomp_with_options()。

用途

提供了一种从源字符串中提取多个字段的机制。这在处理表格信息时尤为有用:源字符串代表表格的一行,字符串的各字段代表该行在各列中的“单元格”。表格可以通过 prg_gdf_read() 从 GDF 读入字符串列表,用 prg_list_access() 按行顺序循环扫描,并用 prg_str_decomp() 将每行字符串分解为字段(Example 小节演示了这一技术)。

错误

  • 可恢复错误:内存分配失败。
  • 程序中止:段违例。(由于字符串指针非法或字符串畸形)

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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