1PCRE2_JIT_COMPILE(3)       Library Functions Manual       PCRE2_JIT_COMPILE(3)
2
3
4

NAME

6       PCRE2 - Perl-compatible regular expressions (revised API)
7

SYNOPSIS

9
10       #include <pcre2.h>
11
12       int pcre2_jit_compile(pcre2_code *code, uint32_t options);
13

DESCRIPTION

15
16       This function requests JIT compilation, which, if the just-in-time com‐
17       piler is available, further processes a compiled pattern  into  machine
18       code  that  executes  much  faster  than the pcre2_match() interpretive
19       matching function. Full details are given in  the  pcre2jit  documenta‐
20       tion.
21
22       The  first argument is a pointer that was returned by a successful call
23       to pcre2_compile(), and the second must contain one or more of the fol‐
24       lowing bits:
25
26         PCRE2_JIT_COMPLETE      compile code for full matching
27         PCRE2_JIT_PARTIAL_SOFT  compile code for soft partial matching
28         PCRE2_JIT_PARTIAL_HARD  compile code for hard partial matching
29
30       There  is  also  an obsolete option called PCRE2_JIT_INVALID_UTF, which
31       has    been    superseded     by     the     pcre2_compile()     option
32       PCRE2_MATCH_INVALID_UTF.  The  old  option  is  deprecated  and  may be
33       removed in the future.
34
35       The yield of the function is 0 for success, or a  negative  error  code
36       otherwise.  In particular, PCRE2_ERROR_JIT_BADOPTION is returned if JIT
37       is not supported or if an unknown bit is set in options.  The  function
38       can  also return PCRE2_ERROR_NOMEMORY if JIT is unable to allocate exe‐
39       cutable memory for the compiler, even if it was  because  of  a  system
40       security restriction.
41
42       There is a complete description of the PCRE2 native API in the pcre2api
43       page and a description of the POSIX API in the pcre2posix page.
44
45
46
47PCRE2 10.34                      29 July 2019             PCRE2_JIT_COMPILE(3)
Impressum