version 1.1, 2012/02/21 23:05:52
|
version 1.1.1.3, 2013/07/22 08:25:57
|
Line 22 SYNOPSIS
|
Line 22 SYNOPSIS
|
<b>int pcre_get_substring_list(const char *<i>subject</i>,</b> |
<b>int pcre_get_substring_list(const char *<i>subject</i>,</b> |
<b>int *<i>ovector</i>, int <i>stringcount</i>, const char ***<i>listptr</i>);</b> |
<b>int *<i>ovector</i>, int <i>stringcount</i>, const char ***<i>listptr</i>);</b> |
</P> |
</P> |
|
<P> |
|
<b>int pcre16_get_substring_list(PCRE_SPTR16 <i>subject</i>,</b> |
|
<b>int *<i>ovector</i>, int <i>stringcount</i>, PCRE_SPTR16 **<i>listptr</i>);</b> |
|
</P> |
|
<P> |
|
<b>int pcre32_get_substring_list(PCRE_SPTR32 <i>subject</i>,</b> |
|
<b>int *<i>ovector</i>, int <i>stringcount</i>, PCRE_SPTR32 **<i>listptr</i>);</b> |
|
</P> |
<br><b> |
<br><b> |
DESCRIPTION |
DESCRIPTION |
</b><br> |
</b><br> |
Line 30 This is a convenience function for extracting a list o
|
Line 38 This is a convenience function for extracting a list o
|
substrings. The arguments are: |
substrings. The arguments are: |
<pre> |
<pre> |
<i>subject</i> Subject that has been successfully matched |
<i>subject</i> Subject that has been successfully matched |
<i>ovector</i> Offset vector that <b>pcre_exec</b> used | <i>ovector</i> Offset vector that <b>pcre[16|32]_exec</b> used |
<i>stringcount</i> Value returned by <b>pcre_exec</b> | <i>stringcount</i> Value returned by <b>pcre[16|32]_exec</b> |
<i>listptr</i> Where to put a pointer to the list |
<i>listptr</i> Where to put a pointer to the list |
</pre> |
</pre> |
The memory in which the substrings and the list are placed is obtained by |
The memory in which the substrings and the list are placed is obtained by |
calling <b>pcre_malloc()</b>. The convenience function | calling <b>pcre[16|32]_malloc()</b>. The convenience function |
<b>pcre_free_substring_list()</b> can be used to free it when it is no longer | <b>pcre[16|32]_free_substring_list()</b> can be used to free it when it is no |
needed. A pointer to a list of pointers is put in the variable whose address is | longer needed. A pointer to a list of pointers is put in the variable whose |
in <i>listptr</i>. The list is terminated by a NULL pointer. The yield of the | address is in <i>listptr</i>. The list is terminated by a NULL pointer. The |
function is zero on success or PCRE_ERROR_NOMEMORY if sufficient memory could | yield of the function is zero on success or PCRE_ERROR_NOMEMORY if sufficient |
not be obtained. | memory could not be obtained. |
</P> |
</P> |
<P> |
<P> |
There is a complete description of the PCRE native API in the |
There is a complete description of the PCRE native API in the |