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 string 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.
 The instance takes ownership of the data, and is responsible for freeing it.
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.
 The instance takes ownership of the data, and is responsible for freeing it.

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.