MatchInfo.fetchNamed

Retrieves the text matching 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 an empty string is returned.

The string is fetched from the string passed to the match function, so you cannot call this function after freeing the string.

class MatchInfo
string
fetchNamed
(
string name
)

Parameters

name string

name of the subexpression

Return Value

Type: string

The matched substring, or %NULL if an error occurred. You have to free the string yourself

Meta

Since

2.14