Introduction to Library Functions     PCREGETNAMEDSUBSTRING(3)



NAME
     PCRE - Perl-compatible regular expressions

SYNOPSIS

     #include 

     int pcregetnamedsubstring(const pcre *code,
          const char *subject, int *ovector,
          int stringcount, const char *stringname,
          const char **stringptr);

DESCRIPTION

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

       code          Compiled pattern
       subject       Subject that has been successfully matched
       ovector       Offset vector that pcreexec() used
       stringcount   Value returned by pcreexec()
       stringname    Name 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 extracted substring, PCRERORNOMEMORY  if  sufficient
     memory  could  not be obtained, or PCRERORNOSUBSTRING if
     the string name 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