You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
58 lines
1.9 KiB
58 lines
1.9 KiB
.TH PCRE2_JIT_MATCH 3 "20 January 2023" "PCRE2 10.43"
|
|
.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.
|
|
.P
|
|
In UTF mode, the subject string is not checked for UTF validity. Unless
|
|
PCRE2_MATCH_INVALID_UTF was set when the pattern was compiled, passing an
|
|
invalid UTF string results in undefined behaviour. Your program may crash or
|
|
loop or give wrong results. In the absence of PCRE2_MATCH_INVALID_UTF you
|
|
should only call \fBpcre2_jit_match()\fP in UTF mode if you are sure the
|
|
subject is valid.
|
|
.P
|
|
The arguments for \fBpcre2_jit_match()\fP 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.
|
|
.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.
|