1PCRE_GET_STRINGNUMBER(3) Library Functions Manual PCRE_GET_STRINGNUMBER(3)
2
3
4
6 PCRE - Perl-compatible regular expressions
7
9
10 #include <pcre.h>
11
12 int pcre_get_stringnumber(const pcre *code,
13 const char *name);
14
15 int pcre16_get_stringnumber(const pcre16 *code,
16 PCRE_SPTR16 name);
17
18 int pcre32_get_stringnumber(const pcre32 *code,
19 PCRE_SPTR32 name);
20
22
23 This convenience function finds the number of a named substring captur‐
24 ing parenthesis in a compiled pattern. Its arguments are:
25
26 code Compiled regular expression
27 name Name whose number is required
28
29 The yield of the function is the number of the parenthesis if the name
30 is found, or PCRE_ERROR_NOSUBSTRING otherwise. When duplicate names are
31 allowed (PCRE_DUPNAMES is set), it is not defined which of the numbers
32 is returned by pcre[16|32]_get_stringnumber(). You can obtain the com‐
33 plete list by calling pcre[16|32]_get_stringtable_entries().
34
35 There is a complete description of the PCRE native API in the pcreapi
36 page and a description of the POSIX API in the pcreposix page.
37
38
39
40PCRE 8.30 24 June 2012 PCRE_GET_STRINGNUMBER(3)