1PCRE2_SUBSTRING_NAMETABLE_SCLAiNb(r3a)ry Functions MPaCnRuEa2l_SUBSTRING_NAMETABLE_SCAN(3)
2
3
4
6 PCRE2 - Perl-compatible regular expressions (revised API)
7
9
10 #include <pcre2.h>
11
12 int pcre2_substring_nametable_scan(const pcre2_code *code,
13 PCRE2_SPTR name, PCRE2_SPTR *first, PCRE2_SPTR *last);
14
16
17 This convenience function finds, for a compiled pattern, the first and
18 last entries for a given name in the table that translates capturing
19 parenthesis names into numbers.
20
21 code Compiled regular expression
22 name Name whose entries required
23 first Where to return a pointer to the first entry
24 last Where to return a pointer to the last entry
25
26 When the name is found in the table, if first is NULL, the function
27 returns a group number, but if there is more than one matching entry,
28 it is not defined which one. Otherwise, when both pointers have been
29 set, the yield of the function is the length of each entry in code
30 units. If the name is not found, PCRE2_ERROR_NOSUBSTRING is returned.
31
32 There is a complete description of the PCRE2 native API, including the
33 format of the table entries, in the pcre2api page, and a description of
34 the POSIX API in the pcre2posix page.
35
36
37
38PCRE2 10.00 21 October 201P4CRE2_SUBSTRING_NAMETABLE_SCAN(3)