/[pcre]/code/trunk/doc/pcre_fullinfo.3
ViewVC logotype

Diff of /code/trunk/doc/pcre_fullinfo.3

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 63 by nigel, Sat Feb 24 21:40:03 2007 UTC revision 678 by ph10, Sun Aug 28 15:23:03 2011 UTC
# Line 1  Line 1 
1  .TH PCRE 3  .TH PCRE_FULLINFO 3
2  .SH NAME  .SH NAME
3  PCRE - Perl-compatible regular expressions  PCRE - Perl-compatible regular expressions
4  .SH SYNOPSIS  .SH SYNOPSIS
# Line 7  PCRE - Perl-compatible regular expressio Line 7  PCRE - Perl-compatible regular expressio
7  .B #include <pcre.h>  .B #include <pcre.h>
8  .PP  .PP
9  .SM  .SM
10  .br  .B int pcre_fullinfo(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP,"
 .B int pcre_fullinfo(const pcre *\fIcode\fR, "const pcre_extra *\fIextra\fR,"  
11  .ti +5n  .ti +5n
12  .B int \fIwhat\fR, void *\fIwhere\fR);  .B int \fIwhat\fP, void *\fIwhere\fP);
13    .
14  .SH DESCRIPTION  .SH DESCRIPTION
15  .rs  .rs
16  .sp  .sp
17  This function returns information about a compiled pattern. Its arguments are:  This function returns information about a compiled pattern. Its arguments are:
18    .sp
19    \fIcode\fR    Compiled regular expression    \fIcode\fP                      Compiled regular expression
20    \fIextra\fR   Result of \fBpcre_study()\fR or NULL    \fIextra\fP                     Result of \fBpcre_study()\fP or NULL
21    \fIwhat\fR    What information is required    \fIwhat\fP                      What information is required
22    \fIwhere\fR   Where to put the information    \fIwhere\fP                     Where to put the information
23    .sp
24  The following information is available:  The following information is available:
25    .sp
26    PCRE_INFO_BACKREFMAX     Number of highest back reference    PCRE_INFO_BACKREFMAX      Number of highest back reference
27    PCRE_INFO_CAPTURECOUNT   Number of capturing subpatterns    PCRE_INFO_CAPTURECOUNT    Number of capturing subpatterns
28    PCRE_INFO_FIRSTBYTE      Fixed first byte for a match, or    PCRE_INFO_DEFAULT_TABLES  Pointer to default tables
29                               -1 for start of string    PCRE_INFO_FIRSTBYTE       Fixed first byte for a match, or
30                                  or after newline, or                                -1 for start of string
31                               -2 otherwise                                   or after newline, or
32    PCRE_INFO_FIRSTTABLE     Table of first bytes                                -2 otherwise
33                               (after studying)    PCRE_INFO_FIRSTTABLE      Table of first bytes (after studying)
34    PCRE_INFO_LASTLITERAL    Literal last byte required    PCRE_INFO_HASCRORLF       Return 1 if explicit CR or LF matches exist
35    PCRE_INFO_NAMECOUNT      Number of named subpatterns    PCRE_INFO_JCHANGED        Return 1 if (?J) or (?-J) was used
36    PCRE_INFO_NAMEENTRYSIZE  Size of name table entry    PCRE_INFO_JIT             Return 1 after successful JIT compilation
37    PCRE_INFO_NAMETABLE      Pointer to name table    PCRE_INFO_LASTLITERAL     Literal last byte required
38    PCRE_INFO_OPTIONS        Options used for compilation    PCRE_INFO_MINLENGTH       Lower bound length of matching strings
39    PCRE_INFO_SIZE           Size of compiled pattern    PCRE_INFO_NAMECOUNT       Number of named subpatterns
40      PCRE_INFO_NAMEENTRYSIZE   Size of name table entry
41      PCRE_INFO_NAMETABLE       Pointer to name table
42      PCRE_INFO_OKPARTIAL       Return 1 if partial matching can be tried
43                                  (always returns 1 after release 8.00)
44      PCRE_INFO_OPTIONS         Option bits used for compilation
45      PCRE_INFO_SIZE            Size of compiled pattern
46      PCRE_INFO_STUDYSIZE       Size of study data
47    .sp
48    The \fIwhere\fP argument must point to an integer variable, except for the
49    following \fIwhat\fP values:
50    .sp
51      PCRE_INFO_DEFAULT_TABLES  const unsigned char *
52      PCRE_INFO_FIRSTTABLE      const unsigned char *
53      PCRE_INFO_NAMETABLE       const unsigned char *
54      PCRE_INFO_OPTIONS         unsigned long int
55      PCRE_INFO_SIZE            size_t
56    .sp
57  The yield of the function is zero on success or:  The yield of the function is zero on success or:
58    .sp
59    PCRE_ERROR_NULL       the argument \fIcode\fR was NULL    PCRE_ERROR_NULL           the argument \fIcode\fP was NULL
60                          the argument \fIwhere\fR was NULL                              the argument \fIwhere\fP was NULL
61    PCRE_ERROR_BADMAGIC   the "magic number" was not found    PCRE_ERROR_BADMAGIC       the "magic number" was not found
62    PCRE_ERROR_BADOPTION  the value of \fIwhat\fR was invalid    PCRE_ERROR_BADOPTION      the value of \fIwhat\fP was invalid
63    .P
64  There is a complete description of the PCRE API in the  There is a complete description of the PCRE native API in the
65    .\" HREF
66    \fBpcreapi\fP
67    .\"
68    page and a description of the POSIX API in the
69  .\" HREF  .\" HREF
70  \fBpcreapi\fR  \fBpcreposix\fP
71  .\"  .\"
72  page.  page.

Legend:
Removed from v.63  
changed lines
  Added in v.678

  ViewVC Help
Powered by ViewVC 1.1.5