Introduction to Library Functions           PCREGETSUBSTRING(3)



NAME
     PCRE - Perl-compatible regular expressions

SYNOPSIS

     #include 

     int pcregetsubstring(const char *subject, int *ovector,
          int stringcount, int stringnumber,
          const char **stringptr);

DESCRIPTION

     This is a convenience function  for  extracting  a  captured
     substring. The arguments are:

       subject       Subject that has been successfully matched
       ovector       Offset vector that pcreexec() used
       stringcount   Value returned by pcreexec()
       stringnumber  Number of the required substring
       stringptr     Where to put the string pointer

     The memory in which the substring is placed is  obtained  by
     calling     pcremalloc().    The    convenience    function
     pcrefreesubstring() can be used to free it when it  is  no
     longer  needed.  The  yield of the function is the length of
     the  substring,  PCRERORNOMEMORY  if  sufficient  memory
     could  not  be  obtained,  or  PCRERORNOSUBSTRING if the
     string number is invalid.

     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