FreeBSD manual
download PDF document: pcre16_get_stringtable_entries.3.pdf
PCRE_GET_STRINGTABLE_ENTRIES(3) FreeBSD Library Functions Manual
NAME
PCRE - Perl-compatible regular expressions
SYNOPSIS
#include <pcre.h>
int pcre_get_stringtable_entries(const pcre *code,
const char *name, char **first, char **last);
int pcre16_get_stringtable_entries(const pcre16 *code,
PCRE_SPTR16 name, PCRE_UCHAR16 **first, PCRE_UCHAR16 **last);
int pcre32_get_stringtable_entries(const pcre32 *code,
PCRE_SPTR32 name, PCRE_UCHAR32 **first, PCRE_UCHAR32 **last);
DESCRIPTION
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 not set), it is usually easier to use
pcre[16|32]_get_stringnumber() instead.
code Compiled regular expression
name Name whose entries required
first Where to return a pointer to the first entry
last Where to return a pointer to the last entry
The yield of the function is the length of each entry, or
PCRE_ERROR_NOSUBSTRING if none are found.
There is a complete description of the PCRE native API, including the
format of the table entries, in the pcreapi page, and a description of
the POSIX API in the pcreposix page.
PCRE 8.30 24 June 2012 PCRE_GET_STRINGTABLE_ENTRIES(3)