包概述

String 包支持对字符串及其内存分配的操作。

如 GDF 包中所述,有时需要从文件中读取并解析表格信息。prg_gdf_read() 函数支持读取 ASCII GDF 并将其存储到字符串列表的过程。通常,这些代表表格各行的文件行必须解析为字段。Str 包的 prg_str_decomp() 和 prg_str_decomp_with_options() 函数支持将字符串分解为字段列表。列表项由某个定界字符分隔;可以使用 prg_string_list_separator_char_get() 获知该字符是什么。可以用 prg_string_contains_list_separator() 判断字符串是否包含列表分隔符。

prg_string_copy() 函数为字符串的副本分配内存,然后执行复制。prg_string_const() 函数返回一个常量字符串。prg_string_free() 函数释放分配给字符串的内存。

可以使用 prg_string_regexp_match() 函数在字符串中查找指定的正则表达式。

可以分别使用 prg_string_order() 和 prg_string_order_case_insensitive() 比较两个字符串(考虑或不考虑大小写)。

可以使用 prg_string_to_double() 和 prg_string_to_integer() 将 double 和整数值的字符串表示转换为对应的 double 或 int。

有几个函数提供了将数值以字符串形式美观格式化的手段——prg_string_double_format()、prg_string_int64_format() 和 prg_string_uint64_format()。格式化数字时,小数点和千位分隔符字符由程序的区域设置(locale)决定。可以使用 prg_string_decimal_point_char_get() 和 prg_string_thousands_separator_char_get() 获知这些字符是什么。

可以使用 prg_string_double_localize() 和 prg_string_double_unlocalize() 更改已格式化字符串中的小数点和千位分隔符字符。此外,还可以用 prg_string_double_unit_convert() 更改 double 所使用的单位。

可以用 prg_string_locale_get() 确定当前区域设置,用 prg_string_locale_begin() 切换到新的区域设置,并用 prg_string_locale_end() 切回原来的区域设置。还可以用 prg_string_posix_locale_begin() 和 prg_string_posix_locale_end() 切换到一个已知安全的区域设置再切回。

还可以使用格式状态(format state)进行额外的格式化。prg_string_format_state_create() 创建一个格式状态,其中包含特定大小数字的格式信息。prg_string_format_state_update() 更新格式状态以处理不同大小的数字。prg_string_format_state_format() 返回按指定格式状态格式化的数字的字符串表示。prg_string_format_state_destroy() 销毁一个格式状态。