Introduction to Library Functions      PCREGETSUBSTRINGLIST(3)



NAME
     PCRE - Perl-compatible regular expressions

SYNOPSIS

     #include 

     int pcregetsubstringlist(const char *subject,
          int *ovector, int stringcount, const char ***listptr);

DESCRIPTION

     This is a convenience function for extracting a list of  all
     the captured substrings. The arguments are:

       subject       Subject that has been successfully matched
       ovector       Offset vector that pcreexec used
       stringcount   Value returned by pcreexec
       listptr       Where to put a pointer to the list

     The memory in which the substrings and the list  are  placed
     is  obtained by calling pcremalloc(). The convenience func-
     tion pcrefreesubstringlist() can be used to free it  when
     it  is  no longer needed. A pointer to a list of pointers is
     put in the variable whose address is in listptr. The list is
     terminated  by  a NUL pointer. The yield of the function is
     zero on success or PCRERORNOMEMORY if sufficient  memory
     could not be obtained.

     There is a complete description of the PCRE  native  API  in
     the  pcreapi  page and a description of the POSIX API in the
     pcreposix page.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE
    
     Availability         SUNWpcre       
    
     Interface Stability  Uncommitted    
    

NOTES
     Source for PCRE is available on http:/opensolaris.org.








SunOS 5.10                Last change:                          1