PCRE — Perl-compatible regular expressions
#include <pcre.h> void pcre_assign_jit_stack(pcre_extra *extra
, pcre_jit_callbackcallback
, void *data
);
This function provides control over the memory used as a
stack at runtime by a call to pcre_exec
() with a pattern that has been
successfully compiled with JIT optimization. The arguments
are:
extra the data pointer returned by pcre_study
()
callback a callback function
data a JIT stack or a value to be passed to the callback
function
If callback
is NULL and
data
is NULL, an internal 32K
block on the machine stack is used.
If callback
is NULL and
data
is not NULL, data
must be a valid JIT stack, the result
of calling pcre_jit_stack_alloc
().
If callback
not NULL, it is
called with data
as an argument
at the start of matching, in order to set up a JIT stack. If
the result is NULL, the internal 32K stack is used; otherwise
the return value must be a valid JIT stack, the result of
calling pcre_jit_stack_alloc
().
You may safely assign the same JIT stack to 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 pcrejit(3) page.
There is a complete description of the PCRE native API in the pcreapi(3) page and a description of the POSIX API in the pcreposix(3) page.
COPYRIGHT |
---|
This manual page is taken from the PCRE library, which is distributed under the BSD license. |