Struct

GLibMatchInfo

Description

struct GMatchInfo {
  /* No available fields */
}

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

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_numth 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_numth 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