1PCRE_GET_SUBSTRING_LIST(3) Library Functions Manual PCRE_GET_SUBSTRING_LIST(3)
2
3
4

NAME

6       PCRE - Perl-compatible regular expressions
7

SYNOPSIS

9
10       #include <pcre.h>
11
12       int pcre_get_substring_list(const char *subject,
13            int *ovector, int stringcount, const char ***listptr);
14

DESCRIPTION

16
17       This  is  a  convenience function for extracting a list of all the cap‐
18       tured substrings. The arguments are:
19
20         subject       Subject that has been successfully matched
21         ovector       Offset vector that pcre_exec used
22         stringcount   Value returned by pcre_exec
23         listptr       Where to put a pointer to the list
24
25       The memory in which the substrings and the list are placed is  obtained
26       by  calling  pcre_malloc().  The  convenience  function  pcre_free_sub‐
27       string_list() can be used to free it when it is  no  longer  needed.  A
28       pointer  to  a list of pointers is put in the variable whose address is
29       in listptr. The list is terminated by a NULL pointer. The yield of  the
30       function is zero on success or PCRE_ERROR_NOMEMORY if sufficient memory
31       could not be obtained.
32
33       There is a complete description of the PCRE native API in  the  pcreapi
34       page and a description of the POSIX API in the pcreposix page.
35
36
37
38                                                    PCRE_GET_SUBSTRING_LIST(3)
Impressum