Method

GLibMatchInfofetch

since: 2.14

Declaration

gchar*
g_match_info_fetch (
  const GMatchInfo* match_info,
  gint match_num
)

Description

Retrieves the text matching the match_numth capturing parentheses. 0 is the full text of the match, 1 is the first paren set, 2 the second, and so on.

If match_num is a valid sub pattern but it didn’t match anything (e.g. sub pattern 1, matching “b” against “(a)?b”) then an empty string is returned.

If the match was obtained using the DFA algorithm, that is using g_regex_match_all() or g_regex_match_all_full(), the retrieved string is not that of a set of parentheses but that of a matched substring. Substrings are matched in reverse order of length, so 0 is the longest match.

The string is fetched from the string passed to the match function, so you cannot call this function after freeing the string.

Available since: 2.14

Parameters

match_num

Type: gint

Number of the sub expression.

Return value

Type: gchar*

The matched substring, or NULL if an error occurred. You have to free the string yourself.

The caller of the method takes ownership of the data, and is responsible for freeing it.
The return value can be NULL.
The value is a NUL terminated UTF-8 string.