165de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<html>
265de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<head>
365de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<title>pcre_get_stringtable_entries specification</title>
465de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</head>
565de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
665de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<h1>pcre_get_stringtable_entries man page</h1>
765de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<p>
865de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichReturn to the <a href="index.html">PCRE index page</a>.
965de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</p>
1065de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<p>
1165de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichThis page is part of the PCRE HTML documentation. It was generated automatically
1265de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichfrom the original man page. If there is any nonsense in it, please consult the
1365de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichman page, in case the conversion went wrong.
1465de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<br>
1565de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<br><b>
1665de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichSYNOPSIS
1765de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</b><br>
1865de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<P>
1965de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<b>#include &#60;pcre.h&#62;</b>
2065de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</P>
2165de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<P>
2265de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<b>int pcre_get_stringtable_entries(const pcre *<i>code</i>,</b>
2365de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<b>     const char *<i>name</i>, char **<i>first</i>, char **<i>last</i>);</b>
2465de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<br>
2565de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<br>
2665de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<b>int pcre16_get_stringtable_entries(const pcre16 *<i>code</i>,</b>
2765de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<b>     PCRE_SPTR16 <i>name</i>, PCRE_UCHAR16 **<i>first</i>, PCRE_UCHAR16 **<i>last</i>);</b>
2865de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<br>
2965de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<br>
3065de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<b>int pcre32_get_stringtable_entries(const pcre32 *<i>code</i>,</b>
3165de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<b>     PCRE_SPTR32 <i>name</i>, PCRE_UCHAR32 **<i>first</i>, PCRE_UCHAR32 **<i>last</i>);</b>
3265de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</P>
3365de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<br><b>
3465de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichDESCRIPTION
3565de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</b><br>
3665de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<P>
3765de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichThis convenience function finds, for a compiled pattern, the first and last
3865de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichentries for a given name in the table that translates capturing parenthesis
3965de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichnames into numbers. When names are required to be unique (PCRE_DUPNAMES is
4065de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<i>not</i> set), it is usually easier to use <b>pcre[16|32]_get_stringnumber()</b>
4165de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichinstead.
4265de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<pre>
4365de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich  <i>code</i>    Compiled regular expression
4465de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich  <i>name</i>    Name whose entries required
4565de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich  <i>first</i>   Where to return a pointer to the first entry
4665de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich  <i>last</i>    Where to return a pointer to the last entry
4765de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</pre>
4865de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichThe yield of the function is the length of each entry, or
4965de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichPCRE_ERROR_NOSUBSTRING if none are found.
5065de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</P>
5165de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<P>
5265de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichThere is a complete description of the PCRE native API, including the format of
5365de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichthe table entries, in the
5465de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<a href="pcreapi.html"><b>pcreapi</b></a>
5565de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichpage, and a description of the POSIX API in the
5665de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<a href="pcreposix.html"><b>pcreposix</b></a>
5765de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevichpage.
5865de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich<p>
5965de34233da93a3d65c00b8aad3ff9aad44c57deNick KralevichReturn to the <a href="index.html">PCRE index page</a>.
6065de34233da93a3d65c00b8aad3ff9aad44c57deNick Kralevich</p>
61