embedaddon/pcre/doc/pcre_fullinfo.3 - diff

Return to pcre_fullinfo.3 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / pcre / doc

Diff for /embedaddon/pcre/doc/pcre_fullinfo.3 between versions 1.1 and 1.1.1.5

version 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

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>

Removed from v.1.1
changed lines
	Added in v.1.1.1.5