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

FreeBSD Manual Pages

  
 
  

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

NAME
       PCRE - Perl-compatible regular expressions

SYNOPSIS
       #include	<pcre.h>

       void pcre_assign_jit_stack(pcre_extra *extra,
	    pcre_jit_callback callback,	void *data);

       void pcre16_assign_jit_stack(pcre16_extra *extra,
	    pcre16_jit_callback	callback, void *data);

       void pcre32_assign_jit_stack(pcre32_extra *extra,
	    pcre32_jit_callback	callback, void *data);

DESCRIPTION
       This  function provides control over the	memory used as a stack at run-
       time by a call to pcre[16|32]_exec() with a pattern that	has been  suc-
       cessfully compiled with JIT optimization. The arguments are:

	 extra	   the data pointer returned by	pcre[16|32]_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 ma-
       chine stack is used.

       If callback is NULL and data is not NULL, data  must  be	 a  valid  JIT
       stack, the result of calling pcre[16|32]_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[16|32]_jit_stack_al-
       loc().

       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  applica-
       tion, each thread must use its own JIT stack. For more details, see the
       pcrejit page.

       There  is  a complete description of the	PCRE native API	in the pcreapi
       page and	a description of the POSIX API in the pcreposix	page.

PCRE 8.30			 24 June 2012	      PCRE_ASSIGN_JIT_STACK(3)

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

home | help