Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
PCRE2_JIT_STACK_ASSIGN(3)   Library Functions Manual   PCRE2_JIT_STACK_ASSIGN(3)

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

SYNOPSIS

     #include <pcre2.h>

     void pcre2_jit_stack_assign(pcre2_match_context *mcontext,
       pcre2_jit_callback callback_function, void *callback_data);

DESCRIPTION

     This  function  provides  control over the memory used by JIT as a run-time
     stack when pcre2_match() or pcre2_jit_match() is called with a pattern that
     has been successfully processed by the JIT compiler. The  information  that
     determines  which	stack is used is put into a match context that is subse-
     quently passed to a matching function. The arguments of this function are:

       mcontext       a pointer to a match context
       callback       a callback function
       callback_data  a JIT stack or a value to be passed to the callback

     If mcontext is NULL, the function returns immediately, without  doing  any-
     thing.

     If  callback  is NULL and callback_data is NULL, an internal 32KiB block on
     the machine stack is used.

     If callback is NULL and callback_data is not NULL, callback_data must be  a
     valid JIT stack, the result of calling pcre2_jit_stack_create().

     If callback not NULL, it is called with callback_data as an argument at the
     start  of	matching, in order to set up a JIT stack. If the result is NULL,
     the internal 32KiB stack is used; otherwise the  return  value  must  be  a
     valid JIT stack, the result of calling pcre2_jit_stack_create().

     You  may  safely  use  the same JIT stack for multiple patterns, as long as
     they are all matched in the same thread. In a multithread application, each
     thread must use its own JIT stack. For more details, see the pcre2jit page.

     There is a complete description of the PCRE2 native  API  in  the	pcre2api
     page and a description of the POSIX API in the pcre2posix page.

PCRE2 10.47			 13 August 2018        PCRE2_JIT_STACK_ASSIGN(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pcre2_jit_stack_assign&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help