Method

GLibMatchInfofetch_named_pos

Declaration

gboolean
g_match_info_fetch_named_pos (
  const GMatchInfo* match_info,
  const gchar* name,
  gint* start_pos,
  gint* end_pos
)

Description

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 “(?Pa)?b”) then start_pos and end_pos are set to -1 and TRUE is returned.

Available since:2.14

Parameters

name const gchar*
 

Name of the subexpression.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
start_pos 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 gint*
 

Pointer to location where to store the end position, or NULL.

 The argument will be set by the function.
 The argument can be NULL.

Return value

Returns: gboolean
 

TRUE if the position was fetched, FALSE otherwise. If the position cannot be fetched, start_pos and end_pos are left unchanged.