Method
GLibMatchInfofetch_named_pos
since: 2.14
Declaration [src]
gboolean
g_match_info_fetch_named_pos (
const GMatchInfo* match_info,
const gchar* name,
gint* start_pos,
gint* end_pos
)
Description [src]
Retrieves the position in bytes of the capturing parentheses named name
.
If name
is a valid sub pattern name but it didn’t match anything
(e.g. sub pattern "X"
, matching "b"
against "(?P<X>a)?b"
)
then start_pos
and end_pos
are set to -1 and TRUE
is returned.
As end_pos
is set to the byte after the final byte of the match (on success),
the length of the match can be calculated as end_pos - start_pos
.
Available since: 2.14
Parameters
name
-
Type:
const gchar*
Name of the subexpression.
The data is owned by the caller of the method. The value is a NUL terminated UTF-8 string. start_pos
-
Type:
gint*
Pointer to location where to store the start position, or
NULL
.The argument will be set by the function. The argument can be NULL
. end_pos
-
Type:
gint*
Pointer to location where to store the end position (the byte after the final byte of the match), or
NULL
.The argument will be set by the function. The argument can be NULL
.