Introduction to Library Functions                PCREDFAEXEC(3)



NAME
     PCRE - Perl-compatible regular expressions

SYNOPSIS

     #include 

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

DESCRIPTION

     This function matches a compiled regular expression  against
     a  given subject string, using an alternative matching algo-
     rithm that scans the subject string  just  once  (not  Perl-
     compatible).  Note  that the main, Perl-compatible, matching
     function is pcreexec(). The  arguments  for  this  function
     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
       workspace    Points to a vector of ints  used  as  working
     space
       wscount      Number of elements in the vector

     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)



SunOS 5.10                Last change:                          1






Introduction to Library Functions                PCREDFAEXEC(3)



       PCREPARTIAL       Return PCRERORPARTIAL for a partial
     match
       PCREDFASHORTEST  Return only the shortest match
       PCREDFARESTART   This is a restart after a partial match

     There are restrictions on what may appear in a pattern  when
     using  this  matching  function.  Details  are  given in the
     pcrematching documentation.

     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.  For  this
     matching function, the matchlimit and matchlimitrecursion
     fields are not used, and must not be set.

     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