方法

GLibMatchInfoexpand_references

自：2.14

声明 [src]

gchar*
g_match_info_expand_references (
  const GMatchInfo* match_info,
  const gchar* string_to_expand,
  GError** error
)

描述 [src]

返回一个包含在 string_to_expand 中的文本的新的字符串，其中引用和转义序列已展开。引用指的是使用 string 对 regex 进行匹配的最后一个匹配，并使用与 g_regex_replace() 同样的语法。

string_to_expand 必须是 UTF-8 编码的，即使传递了 G_REGEX_RAW 给 g_regex_new()。

从传递给匹配函数的字符串中提取回溯引用，因此您不能在释放字符串后调用此函数。

如果 match_info 为 NULL，则 string_to_expand 不能包含引用。例如，“foo\n”并不指向一个实际的模式，而'\n'将仅被替换为\n字符；要展开"\0"（整个匹配），则需要匹配的结果。使用 g_regex_check_replacement() 查找 string_to_expand 是否包含引用。

自：2.14

参数

string_to_expand

类型： const gchar*

要展开的字符串。

数据由方法调用者拥有。

该值是包含零终止符的 UTF-8 字符串。

error

类型： GError **

一个可恢复错误的返回位置的地址。

该参数可以为 NULL。

如果返回位置不是 NULL，则必须将其初始化为 NULL GError*。

如果没有错误，则方法将根据需要初始化该参数为 NULL。

如果发生错误，则该参数将设置为一个新分配的 GError；调用者将拥有数据，并负责释放数据。

返回值

类型： gchar*

展开的字符串，或者在发生错误时为 NULL。

方法的调用者拥有返回的数据，并负责释放它。

返回值可以为 NULL。

该值是包含零终止符的 UTF-8 字符串。