1<html>
2<head>
3<title>pcre_get_stringtable_entries specification</title>
4</head>
5<body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
6<h1>pcre_get_stringtable_entries man page</h1>
7<p>
8Return to the <a href="index.html">PCRE index page</a>.
9</p>
10<p>
11This page is part of the PCRE HTML documentation. It was generated automatically
12from the original man page. If there is any nonsense in it, please consult the
13man page, in case the conversion went wrong.
14<br>
15<br><b>
16SYNOPSIS
17</b><br>
18<P>
19<b>#include &#60;pcre.h&#62;</b>
20</P>
21<P>
22<b>int pcre_get_stringtable_entries(const pcre *<i>code</i>,</b>
23<b>const char *<i>name</i>, char **<i>first</i>, char **<i>last</i>);</b>
24</P>
25<P>
26<b>int pcre16_get_stringtable_entries(const pcre16 *<i>code</i>,</b>
27<b>PCRE_SPTR16 <i>name</i>, PCRE_UCHAR16 **<i>first</i>, PCRE_UCHAR16 **<i>last</i>);</b>
28</P>
29<br><b>
30DESCRIPTION
31</b><br>
32<P>
33This convenience function finds, for a compiled pattern, the first and last
34entries for a given name in the table that translates capturing parenthesis
35names into numbers. When names are required to be unique (PCRE_DUPNAMES is
36<i>not</i> set), it is usually easier to use <b>pcre[16]_get_stringnumber()</b>
37instead.
38<pre>
39  <i>code</i>    Compiled regular expression
40  <i>name</i>    Name whose entries required
41  <i>first</i>   Where to return a pointer to the first entry
42  <i>last</i>    Where to return a pointer to the last entry
43</pre>
44The yield of the function is the length of each entry, or
45PCRE_ERROR_NOSUBSTRING if none are found.
46</P>
47<P>
48There is a complete description of the PCRE native API, including the format of
49the table entries, in the
50<a href="pcreapi.html"><b>pcreapi</b></a>
51page, and a description of the POSIX API in the
52<a href="pcreposix.html"><b>pcreposix</b></a>
53page.
54<p>
55Return to the <a href="index.html">PCRE index page</a>.
56</p>
57