Manual Pages for UNIX Operating System command usage for man pcre_get_substring_list

Introduction to Library Functions      PCRE_GET_SUBSTRING_LIST(3)



NAME
     PCRE - Perl-compatible regular expressions

SYNOPSIS

     #include 

     int pcre_get_substring_list(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 pcre_exec used
       stringcount   Value returned by pcre_exec
       listptr       Where to put a pointer to the list

     The memory in which the substrings and the list  are  placed
     is  obtained by calling pcre_malloc(). The convenience func-
     tion pcre_free_substring_list() 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 NULL pointer. The yield of the function is
     zero on success or PCRE_ERROR_NOMEMORY 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.

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

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  library/pcre   |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

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








SunOS 5.10                Last change:                          1