Method
GLibRegexmatch_all
since: 2.14
Declaration [src]
gboolean
g_regex_match_all (
const GRegex* regex,
const gchar* string,
GRegexMatchFlags match_options,
GMatchInfo** match_info
)
Description [src]
Using the standard algorithm for regular expression matching only the longest match in the string is retrieved. This function uses a different algorithm so it can retrieve all the possible matches. For more documentation see g_regex_match_all_full().
A GMatchInfo
structure, used to get information on the match, is
stored in match_info
if not NULL
. Note that if match_info
is
not NULL
then it is created even if the function returns FALSE
,
i.e. you must free it regardless if regular expression actually matched.
string
is not copied and is used in GMatchInfo
internally. If
you use any GMatchInfo
method (except g_match_info_free()) after
freeing or modifying string
then the behaviour is undefined.
Available since: 2.14
Parameters
string
-
Type:
const gchar*
The string to scan for matches.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. match_options
-
Type:
GRegexMatchFlags
Match options.
match_info
-
Type:
GMatchInfo
Pointer to location where to store the
GMatchInfo
, orNULL
if you do not need it.The argument will be set by the function. The argument can be NULL
.The caller of the method takes ownership of the returned data, and is responsible for freeing it.