Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pcre2_jit_match (3)

Name

pcre2_jit_match - compatible regular expressions (revised API)

Synopsis

#include <pcre2.h>

int pcre2_jit_match(const pcre2_code *code, PCRE2_SPTR subject,
PCRE2_SIZE length, PCRE2_SIZE startoffset,
uint32_t options, pcre2_match_data *match_data,
pcre2_match_context *mcontext);

Description

PCRE2_JIT_MATCH(3)         Library Functions Manual         PCRE2_JIT_MATCH(3)



NAME
       PCRE2 - Perl-compatible regular expressions (revised API)

SYNOPSIS

       #include <pcre2.h>

       int pcre2_jit_match(const pcre2_code *code, PCRE2_SPTR subject,
         PCRE2_SIZE length, PCRE2_SIZE startoffset,
         uint32_t options, pcre2_match_data *match_data,
         pcre2_match_context *mcontext);

DESCRIPTION

       This  function matches a compiled regular expression that has been suc-
       cessfully 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
       pcre2_match()  applies.   Its  arguments  are  exactly  the same as for
       pcre2_match(), except that the subject string must be specified with  a
       length; PCRE2_ZERO_TERMINATED is not supported.

       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.

       The  return  values  are   the   same   as   for   pcre2_match()   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 pcre2partial page.

       There is a complete description of the PCRE2 native API in the pcre2api
       page and a description of the JIT API in the pcre2jit page.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/pcre2    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source     was     downloaded     from       https://github.com/Philip-
       Hazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz.

       Further information about this software can be found on the open source
       community website at http://pcre.org/.



PCRE2 10.35                    11 February 2020             PCRE2_JIT_MATCH(3)