### Struct

# GLib MatchInfo

since: 2.0

#### Description

    struct GMatchInfo {
      /* No available fields */
    }

A GMatchInfo is an opaque struct used to return information about matches.

Available since: 2.0

#### Instance methods

###### g_match_info_expand_references

Returns a new string containing the text in `string_to_expand` with references and escape sequences expanded. References refer to the last match done with `string` against `regex` and have the same syntax used by g_regex_replace().

since: 2.14

###### g_match_info_fetch

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

since: 2.14

###### g_match_info_fetch_all

Bundles up pointers to each of the matching substrings from a match and stores them in an array of gchar pointers. The first element in the returned array is the match number 0, i.e. the entire matched text.

since: 2.14

###### g_match_info_fetch_named

Retrieves the text matching the capturing parentheses named `name`.

since: 2.14

###### g_match_info_fetch_named_pos

Retrieves the position in bytes of the capturing parentheses named `name`.

since: 2.14

###### g_match_info_fetch_pos

Retrieves the position in bytes of the `match_num`‘th capturing parentheses. 0 is the full text of the match, 1 is the first paren set, 2 the second, and so on.

since: 2.14

###### g_match_info_free

If `match_info` is not `NULL`, calls g_match_info_unref(); otherwise does nothing.

since: 2.14

###### g_match_info_get_match_count

Retrieves the number of matched substrings (including substring 0, that is the whole matched text), so 1 is returned if the pattern has no substrings in it and 0 is returned if the match failed.

since: 2.14

###### g_match_info_get_regex

Returns `GRegex` object used in `match_info`. It belongs to Glib and must not be freed. Use `g_regex_ref()` if you need to keep it after you free `match_info` object.

since: 2.14

###### g_match_info_get_string

Returns the string searched with `match_info`. This is the string passed to `g_regex_match()` or `g_regex_replace()` so you may not free it before calling this function.

since: 2.14

###### g_match_info_is_partial_match

Usually if the string passed to g_regex_match*() matches as far as it goes, but is too short to match the entire pattern, `FALSE` is returned. There are circumstances where it might be helpful to distinguish this case from other cases in which there is no match.

since: 2.14

###### g_match_info_matches

Returns whether the previous match operation succeeded.

since: 2.14

###### g_match_info_next

Scans for the next match using the same parameters of the previous call to `g_regex_match_full()` or `g_regex_match()` that returned `match_info`.

since: 2.14

###### g_match_info_ref

Increases reference count of `match_info` by 1.

since: 2.30

###### g_match_info_unref

Decreases reference count of `match_info` by 1. When reference count drops to zero, it frees all the memory associated with the match_info structure.

since: 2.30