1FUNCTION::MATCHED(3stap)A collection of standard strinFUNCTION::MATCHED(3stap)
2
3
4

NAME

6       function::matched - Return a given matched subexpression.
7

SYNOPSIS

9           matched:string(n:long)
10

ARGUMENTS

12       n
13           index to the subexpression to return. 0 corresponds to the entire
14           regular expression.
15

DESCRIPTION

17       returns the content of the n'th subexpression of the last successful
18       use of the =~ regex matching operator. Returns an empty string if the
19       n'th subexpression was not matched (e.g. due to alternation). Throws an
20       error if the last use of =~ was a failed match, or if fewer than n
21       subexpressions are present in the original regexp.
22

SEE ALSO

24       tapset::regex(3stap)
25
26
27
28SystemTap Tapset Reference         May 2019           FUNCTION::MATCHED(3stap)