Struct
GLibMatchInfo
Description [src]
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_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_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_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