51 lines
1.6 KiB
Groff
51 lines
1.6 KiB
Groff
.TH PCRE2_JIT_MATCH 3 "11 February 2020" "PCRE2 10.35"
|
|
.SH NAME
|
|
PCRE2 - Perl-compatible regular expressions (revised API)
|
|
.SH SYNOPSIS
|
|
.rs
|
|
.sp
|
|
.B #include <pcre2.h>
|
|
.PP
|
|
.nf
|
|
.B int pcre2_jit_match(const pcre2_code *\fIcode\fP, PCRE2_SPTR \fIsubject\fP,
|
|
.B " PCRE2_SIZE \fIlength\fP, PCRE2_SIZE \fIstartoffset\fP,"
|
|
.B " uint32_t \fIoptions\fP, pcre2_match_data *\fImatch_data\fP,"
|
|
.B " pcre2_match_context *\fImcontext\fP);"
|
|
.fi
|
|
.
|
|
.SH DESCRIPTION
|
|
.rs
|
|
.sp
|
|
This function matches a compiled regular expression that has been successfully
|
|
processed by the JIT compiler against a given subject string, using a matching
|
|
algorithm that is similar to Perl's. It is a "fast path" interface to JIT, and
|
|
it bypasses some of the sanity checks that \fBpcre2_match()\fP applies.
|
|
Its arguments are exactly the same as for
|
|
.\" HREF
|
|
\fBpcre2_match()\fP,
|
|
.\"
|
|
except that the subject string must be specified with a length;
|
|
PCRE2_ZERO_TERMINATED is not supported.
|
|
.P
|
|
The supported options are PCRE2_NOTBOL, PCRE2_NOTEOL, PCRE2_NOTEMPTY,
|
|
PCRE2_NOTEMPTY_ATSTART, PCRE2_PARTIAL_HARD, and PCRE2_PARTIAL_SOFT. Unsupported
|
|
options are ignored. The subject string is not checked for UTF validity.
|
|
.P
|
|
The return values are the same as for \fBpcre2_match()\fP plus
|
|
PCRE2_ERROR_JIT_BADOPTION if a matching mode (partial or complete) is requested
|
|
that was not compiled. For details of partial matching, see the
|
|
.\" HREF
|
|
\fBpcre2partial\fP
|
|
.\"
|
|
page.
|
|
.P
|
|
There is a complete description of the PCRE2 native API in the
|
|
.\" HREF
|
|
\fBpcre2api\fP
|
|
.\"
|
|
page and a description of the JIT API in the
|
|
.\" HREF
|
|
\fBpcre2jit\fP
|
|
.\"
|
|
page.
|