1PCRE2_SUBSTRING_NUMBER_FROM_LNiAbMrEa(r3y)FunctionsPCMRaEn2u_aSlUBSTRING_NUMBER_FROM_NAME(3)
2
3
4
6 PCRE2 - Perl-compatible regular expressions (revised API)
7
9
10 #include <pcre2.h>
11
12 int pcre2_substring_number_from_name(const pcre2_code *code,
13 PCRE2_SPTR name);
14
16
17 This convenience function finds the number of a named substring capturā
18 ing parenthesis in a compiled pattern, provided that it is a unique
19 name. The function arguments are:
20
21 code Compiled regular expression
22 name Name whose number is required
23
24 The yield of the function is the number of the parenthesis if the name
25 is found, or PCRE2_ERROR_NOSUBSTRING if it is not found. When duplicate
26 names are allowed (PCRE2_DUPNAMES is set), if the name is not unique,
27 PCRE2_ERROR_NOUNIQUESUBSTRING is returned. You can obtain the list of
28 numbers with the same name by calling pcre2_substring_nametable_scan().
29
30 There is a complete description of the PCRE2 native API in the pcre2api
31 page and a description of the POSIX API in the pcre2posix page.
32
33
34
35PCRE2 10.00 21 October 2P0C1R4E2_SUBSTRING_NUMBER_FROM_NAME(3)