man-pages/man3/pcre2_jit_match.3.html
2021-03-31 01:06:50 +01:00

83 lines
2.2 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of PCRE2_JIT_MATCH</TITLE>
</HEAD><BODY>
<H1>PCRE2_JIT_MATCH</H1>
Section: C Library Functions (3)<BR>Updated: 03 November 2014<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
PCRE2 - Perl-compatible regular expressions (revised API)
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<P>
<B>#include &lt;<A HREF="file:///usr/include/pcre2.h">pcre2.h</A>&gt;</B>
<P>
<PRE>
<B>int pcre2_jit_match(const pcre2_code *</B><I>code</I>, PCRE2_SPTR <I>subject</I>,
<B> PCRE2_SIZE </B><I>length</I>, PCRE2_SIZE <I>startoffset</I>,
<B> uint32_t </B><I>options</I>, pcre2_match_data *<I>match_data</I>,
<B> pcre2_match_context *</B><I>mcontext</I>);
</PRE>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
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 &quot;fast path&quot; interface to JIT, and
it bypasses some of the sanity checks that <B>pcre2_match()</B> applies.
Its arguments are exactly the same as for
<B>pcre2_match()</B>.
<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 <B>pcre2_match()</B> 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
<B>pcre2partial</B>
page.
<P>
There is a complete description of the PCRE2 native API in the
<B>pcre2api</B>
page and a description of the JIT API in the
<B>pcre2jit</B>
page.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="1"><A HREF="#lbAB">NAME</A><DD>
<DT id="2"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="3"><A HREF="#lbAD">DESCRIPTION</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:50 GMT, March 31, 2021
</BODY>
</HTML>