pcre_get_stringtable_entries(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | COLOPHON

PCRE_GET_STRINGTABLE_ENTRIES(3) FunctionsPManualT_STRINGTABLE_ENTRIES(3)

NAME         top

       PCRE - Perl-compatible regular expressions

SYNOPSIS         top


       #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         top


       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.

COLOPHON         top

       This page is part of the PCRE (Perl Compatible Regular
       Expressions) project.  Information about the project can be found
       at ⟨http://www.pcre.org/⟩.  If you have a bug report for this
       manual page, see
       ⟨http://bugs.exim.org/enter_bug.cgi?product=PCRE⟩.  This page was
       obtained from the tarball pcre-8.44.tar.gz fetched from
       ⟨ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/⟩ on
       2021-04-01.  If you discover any rendering problems in this HTML
       version of the page, or you believe there is a better or more up-
       to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to
       man-pages@man7.org

PCRE 8.30                     24 June 2012PCRE_GET_STRINGTABLE_ENTRIES(3)