Method

GLibMatchInfofetch_named_pos

since: 2.14

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

Type: 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

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, or NULL.

The argument will be set by the function.

The argument can be NULL.

Return value

Type: gboolean

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