File:  [ELWIX - Embedded LightWeight unIX -] / embedaddon / pcre / doc / html / pcre_get_stringtable_entries.html
Revision 1.1.1.2 (vendor branch): download - view: text, annotated - select for diffs - revision graph
Tue Feb 21 23:50:25 2012 UTC (12 years, 5 months ago) by misho
Branches: pcre, MAIN
CVS tags: v8_31, v8_30, HEAD
pcre

    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>
    8: Return to the <a href="index.html">PCRE index page</a>.
    9: </p>
   10: <p>
   11: This page is part of the PCRE HTML documentation. It was generated automatically
   12: from the original man page. If there is any nonsense in it, please consult the
   13: man page, in case the conversion went wrong.
   14: <br>
   15: <br><b>
   16: SYNOPSIS
   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>
   30: DESCRIPTION
   31: </b><br>
   32: <P>
   33: This convenience function finds, for a compiled pattern, the first and last
   34: entries for a given name in the table that translates capturing parenthesis
   35: names 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>
   37: instead.
   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>
   44: The yield of the function is the length of each entry, or
   45: PCRE_ERROR_NOSUBSTRING if none are found.
   46: </P>
   47: <P>
   48: There is a complete description of the PCRE native API, including the format of
   49: the table entries, in the
   50: <a href="pcreapi.html"><b>pcreapi</b></a>
   51: page, and a description of the POSIX API in the
   52: <a href="pcreposix.html"><b>pcreposix</b></a>
   53: page.
   54: <p>
   55: Return to the <a href="index.html">PCRE index page</a>.
   56: </p>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>