PCRE — Perl-compatible regular expressions
#include <pcre.h>
int
pcre_dfa_exec( |
const pcre * | code, |
| const pcre_extra * | extra, | |
| const char * | subject, | |
| int | length, | |
| int | startoffset, | |
| int | options, | |
| int * | ovector, | |
| int | ovecsize, | |
| int * | workspace, | |
| int | wscount); |
This function matches a compiled regular expression
against a given subject string, using an alternative matching
algorithm that scans the subject string just once
(not Perl-compatible).
Note that the main, Perl-compatible, matching function is
pcre_exec(). The arguments for
this function are:
codePoints to the compiled patternextraPoints to an associated pcre_extra structure, or is NULLsubjectPoints to the subject stringlengthLength of the subject string, in bytesstartoffsetOffset in bytes in the subject at which to start matchingoptionsOption bitsovectorPoints to a vector of ints for result offsetsovecsizeNumber of elements in the vectorworkspacePoints to a vector of ints used as working spacewscountNumber of elements in the vector
The options are:
PCRE_ANCHORED Match only at the first position
PCRE_BSR_ANYCRLF \R matches only CR, LF, or CRLF
PCRE_BSR_UNICODE \R matches all Unicode line endings
PCRE_NEWLINE_ANY Recognize any Unicode newline sequence
PCRE_NEWLINE_ANYCRLF Recognize CR, LF, and CRLF as newline sequences
PCRE_NEWLINE_CR Set CR as the newline sequence
PCRE_NEWLINE_CRLF Set CRLF as the newline sequence
PCRE_NEWLINE_LF Set LF as the newline sequence
PCRE_NOTBOL Subject is not the beginning of a line
PCRE_NOTEOL Subject is not the end of a line
PCRE_NOTEMPTY An empty string is not a valid match
PCRE_NO_UTF8_CHECK Do not check the subject for UTF-8
validity (only relevant if PCRE_UTF8
was set at compile time)
PCRE_PARTIAL Return PCRE_ERROR_PARTIAL for a partial match
PCRE_DFA_SHORTEST Return only the shortest match
PCRE_DFA_RESTART 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(3) documentation.
A pcre_extra structure contains the following fields:
flagsBits indicating which fields are setstudy_dataOpaque data frompcre_study()match_limitLimit on internal resource usematch_limit_recursionLimit on internal recursion depthcallout_dataOpaque data passed back to calloutstablesPoints to character tables or is NULL
The flag bits are PCRE_EXTRA_STUDY_DATA,
PCRE_EXTRA_MATCH_LIMIT, PCRE_EXTRA_MATCH_LIMIT_RECURSION,
PCRE_EXTRA_CALLOUT_DATA, and PCRE_EXTRA_TABLES. For this
matching function, the match_limit and match_limit_recursion fields are not used,
and must not be set.
There is a complete description of the PCRE native API in the pcreapi(3) page and a description of the POSIX API in the pcreposix(3) page.
| COPYRIGHT |
|---|
|
This manual page is taken from the PCRE library, which is distributed under the BSD license. |