Introduction to Library Functions                PCREFULINFO(3)



NAME
     PCRE - Perl-compatible regular expressions

SYNOPSIS

     #include 

     int pcrefullinfo(const pcre *code, const pcreextra *extra,
          int what, void *where);

DESCRIPTION

     This function returns information about a compiled  pattern.
     Its arguments are:

       code                      Compiled regular expression
       extra                     Result of pcrestudy() or NUL
       what                      What information is required
       where                     Where to put the information

     The following information is available:

       PCREINFOBACKREFMAX      Number of highest back reference
       PCREINFOCAPTURECOUNT    Number of capturing subpatterns
       PCREINFODEFAULTABLES  Pointer to default tables
       PCREINFOFIRSTBYTE       Fixed first byte for a match, or
                                   -1 for start of string
                                      or after newline, or
                                   -2 otherwise
       PCREINFOFIRSTABLE       Table  of  first  bytes  (after
     studying)
       PCREINFOJCHANGED        Return 1 if (?J)  or  (?-J)  was
     used
       PCREINFOLASTLITERAL     Literal last byte required
       PCREINFONAMECOUNT       Number of named subpatterns
       PCREINFONAMENTRYSIZE   Size of name table entry
       PCREINFONAMETABLE       Pointer to name table
       PCREINFOKPARTIAL       Return 1 if partial matching can
     be tried
       PCREINFOPTIONS         Option bits used for compilation
       PCREINFOSIZE            Size of compiled pattern
       PCREINFOSTUDYSIZE       Size of study data

     The yield of the function is zero on success or:

       PCRERORNUL           the argument code was NUL
                                 the argument where was NUL
       PCRERORBADMAGIC       the "magic number" was not found
       PCRERORBADOPTION      the value of what was invalid

     There is a complete description of the PCRE  native  API  in
     the  pcreapi  page and a description of the POSIX API in the



SunOS 5.10                Last change:                          1






Introduction to Library Functions                PCREFULINFO(3)



     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