1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950 |
- .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.
|