version 1.1.1.1, 2012/02/21 23:05:52
|
version 1.1.1.5, 2014/06/15 19:46:04
|
Line 1
|
Line 1
|
.TH PCRE_FULLINFO 3 | .TH PCRE_FULLINFO 3 "24 June 2012" "PCRE 8.30" |
.SH NAME |
.SH NAME |
PCRE - Perl-compatible regular expressions |
PCRE - Perl-compatible regular expressions |
.SH SYNOPSIS |
.SH SYNOPSIS |
Line 6 PCRE - Perl-compatible regular expressions
|
Line 6 PCRE - Perl-compatible regular expressions
|
.sp |
.sp |
.B #include <pcre.h> |
.B #include <pcre.h> |
.PP |
.PP |
.SM | .nf |
.B int pcre_fullinfo(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP," |
.B int pcre_fullinfo(const pcre *\fIcode\fP, "const pcre_extra *\fIextra\fP," |
.ti +5n | .B " int \fIwhat\fP, void *\fIwhere\fP);" |
.B int \fIwhat\fP, void *\fIwhere\fP); | . |
| .B int pcre16_fullinfo(const pcre16 *\fIcode\fP, "const pcre16_extra *\fIextra\fP," |
| .B " int \fIwhat\fP, void *\fIwhere\fP);" |
| .sp |
| .B int pcre32_fullinfo(const pcre32 *\fIcode\fP, "const pcre32_extra *\fIextra\fP," |
| .B " int \fIwhat\fP, void *\fIwhere\fP);" |
| .fi |
. |
. |
.SH DESCRIPTION |
.SH DESCRIPTION |
.rs |
.rs |
Line 17 PCRE - Perl-compatible regular expressions
|
Line 23 PCRE - Perl-compatible regular expressions
|
This function returns information about a compiled pattern. Its arguments are: |
This function returns information about a compiled pattern. Its arguments are: |
.sp |
.sp |
\fIcode\fP Compiled regular expression |
\fIcode\fP Compiled regular expression |
\fIextra\fP Result of \fBpcre_study()\fP or NULL | \fIextra\fP Result of \fBpcre[16|32]_study()\fP or NULL |
\fIwhat\fP What information is required |
\fIwhat\fP What information is required |
\fIwhere\fP Where to put the information |
\fIwhere\fP Where to put the information |
.sp |
.sp |
Line 26 The following information is available:
|
Line 32 The following information is available:
|
PCRE_INFO_BACKREFMAX Number of highest back reference |
PCRE_INFO_BACKREFMAX Number of highest back reference |
PCRE_INFO_CAPTURECOUNT Number of capturing subpatterns |
PCRE_INFO_CAPTURECOUNT Number of capturing subpatterns |
PCRE_INFO_DEFAULT_TABLES Pointer to default tables |
PCRE_INFO_DEFAULT_TABLES Pointer to default tables |
PCRE_INFO_FIRSTBYTE Fixed first byte for a match, or | PCRE_INFO_FIRSTBYTE Fixed first data unit for a match, or |
-1 for start of string |
-1 for start of string |
or after newline, or |
or after newline, or |
-2 otherwise |
-2 otherwise |
PCRE_INFO_FIRSTTABLE Table of first bytes (after studying) | PCRE_INFO_FIRSTTABLE Table of first data units (after studying) |
PCRE_INFO_HASCRORLF Return 1 if explicit CR or LF matches exist |
PCRE_INFO_HASCRORLF Return 1 if explicit CR or LF matches exist |
PCRE_INFO_JCHANGED Return 1 if (?J) or (?-J) was used |
PCRE_INFO_JCHANGED Return 1 if (?J) or (?-J) was used |
PCRE_INFO_JIT Return 1 after successful JIT compilation |
PCRE_INFO_JIT Return 1 after successful JIT compilation |
PCRE_INFO_LASTLITERAL Literal last byte required | PCRE_INFO_JITSIZE Size of JIT compiled code |
| PCRE_INFO_LASTLITERAL Literal last data unit required |
PCRE_INFO_MINLENGTH Lower bound length of matching strings |
PCRE_INFO_MINLENGTH Lower bound length of matching strings |
PCRE_INFO_NAMECOUNT Number of named subpatterns |
PCRE_INFO_NAMECOUNT Number of named subpatterns |
PCRE_INFO_NAMEENTRYSIZE Size of name table entry |
PCRE_INFO_NAMEENTRYSIZE Size of name table entry |
Line 44 The following information is available:
|
Line 51 The following information is available:
|
PCRE_INFO_OPTIONS Option bits used for compilation |
PCRE_INFO_OPTIONS Option bits used for compilation |
PCRE_INFO_SIZE Size of compiled pattern |
PCRE_INFO_SIZE Size of compiled pattern |
PCRE_INFO_STUDYSIZE Size of study data |
PCRE_INFO_STUDYSIZE Size of study data |
|
PCRE_INFO_FIRSTCHARACTER Fixed first data unit for a match |
|
PCRE_INFO_FIRSTCHARACTERFLAGS Returns |
|
1 if there is a first data character set, which can |
|
then be retrieved using PCRE_INFO_FIRSTCHARACTER, |
|
2 if the first character is at the start of the data |
|
string or after a newline, and |
|
0 otherwise |
|
PCRE_INFO_REQUIREDCHAR Literal last data unit required |
|
PCRE_INFO_REQUIREDCHARFLAGS Returns 1 if the last data character is set (which can then |
|
be retrieved using PCRE_INFO_REQUIREDCHAR); 0 otherwise |
.sp |
.sp |
The \fIwhere\fP argument must point to an integer variable, except for the |
The \fIwhere\fP argument must point to an integer variable, except for the |
following \fIwhat\fP values: |
following \fIwhat\fP values: |
.sp |
.sp |
PCRE_INFO_DEFAULT_TABLES const unsigned char * |
PCRE_INFO_DEFAULT_TABLES const unsigned char * |
PCRE_INFO_FIRSTTABLE const unsigned char * |
PCRE_INFO_FIRSTTABLE const unsigned char * |
PCRE_INFO_NAMETABLE const unsigned char * | PCRE_INFO_NAMETABLE PCRE_SPTR16 (16-bit library) |
| PCRE_INFO_NAMETABLE PCRE_SPTR32 (32-bit library) |
| PCRE_INFO_NAMETABLE const unsigned char * (8-bit library) |
PCRE_INFO_OPTIONS unsigned long int |
PCRE_INFO_OPTIONS unsigned long int |
PCRE_INFO_SIZE size_t |
PCRE_INFO_SIZE size_t |
|
PCRE_INFO_FIRSTCHARACTER uint32_t |
|
PCRE_INFO_REQUIREDCHAR uint32_t |
.sp |
.sp |
The yield of the function is zero on success or: |
The yield of the function is zero on success or: |
.sp |
.sp |