Introduction to Library Functions                    PCREXEC(3)



NAME
     PCRE - Perl-compatible regular expressions

SYNOPSIS

     #include 

     int pcreexec(const pcre *code, const pcreextra *extra,
          const char *subject, int length, int startoffset,
          int options, int *ovector, int ovecsize);

DESCRIPTION

     This function matches a compiled regular expression  against
     a  given  subject string, using a matching algorithm that is
     similar to Perl's.  It  returns  offsets  to  captured  sub-
     strings. Its arguments are:

       code         Points to the compiled pattern
       extra        Points to an associated pcreextra structure,
                      or is NUL
       subject      Points to the subject string
       length       Length of the subject string, in bytes
       startoffset  Offset in bytes in the subject at which to
                      start matching
       options      Option bits
       ovector      Points to a vector of ints for result offsets
       ovecsize     Number of elements in the vector (a  multiple
     of 3)

     The options are:

       PCREANCHORED      Match only at the first position
       PCREBSRANYCRLF   \R matches only CR, LF, or CRLF
       PCREBSRUNICODE   \R matches all Unicode line endings
       PCRENEWLINEANY   Recognize any Unicode newline sequence
       PCRENEWLINEANYCRLF  Recognize CR, LF, and CRLF  as  new-
     line sequences
       PCRENEWLINECR    Set CR as the newline sequence
       PCRENEWLINECRLF  Set CRLF as the newline sequence
       PCRENEWLINELF    Set LF as the newline sequence
       PCRENOTBOL        Subject is not the beginning of a line
       PCRENOTEOL        Subject is not the end of a line
       PCRENOTEMPTY      An empty string is not a valid match
       PCRENOUTF8CHECK Do not check the subject for UTF-8
                            validity (only relevant if PCREUTF8
                            was set at compile time)
       PCREPARTIAL       Return PCRERORPARTIAL for a partial
     match

     There are restrictions on what may appear in a pattern  when
     partial   matching   is  requested.  For  details,  see  the



SunOS 5.10                Last change:                          1






Introduction to Library Functions                    PCREXEC(3)



     pcrepartial page.

     A pcreextra structure contains the following fields:

       flags        Bits indicating which fields are set
       studydata   Opaque data from pcrestudy()
       matchlimit  Limit on internal resource use
       matchlimitrecursion  Limit on internal recursion depth
       calloutdata Opaque data passed back to callouts
       tables       Points to character tables or is NUL

     The      flag      bits      are      PCREXTRASTUDYDATA,
     PCREXTRAMATCHLIMIT,    PCREXTRAMATCHLIMITRECURSION,
     PCREXTRACALOUTDATA, and PCREXTRATABLES.

     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:                          2