.TH PCRE_GET_STRINGTABLE_ENTRIES 3 .SH NAME PCRE - Perl-compatible regular expressions .SH SYNOPSIS .rs .sp .B #include .PP .SM .B int pcre_get_stringtable_entries(const pcre *\fIcode\fP, .ti +5n .B const char *\fIname\fP, char **\fIfirst\fP, char **\fIlast\fP); . .SH DESCRIPTION .rs .sp This convenience function finds, for a compiled pattern, the first and last entries for a given name in the table that translates capturing parenthesis names into numbers. When names are required to be unique (PCRE_DUPNAMES is \fInot\fP set), it is usually easier to use \fBpcre_get_stringnumber()\fP instead. .sp \fIcode\fP Compiled regular expression \fIname\fP Name whose entries required \fIfirst\fP Where to return a pointer to the first entry \fIlast\fP Where to return a pointer to the last entry .sp The yield of the function is the length of each entry, or PCRE_ERROR_NOSUBSTRING if none are found. .P There is a complete description of the PCRE native API, including the format of the table entries, in the .\" HREF \fBpcreapi\fP .\" page, and a description of the POSIX API in the .\" HREF \fBpcreposix\fP .\" page.