chiark / gitweb /
Merge from existing archive branch
[pcre3.git] / doc / html / pcre_jit_stack_alloc.html
1 <html>
2 <head>
3 <title>pcre_jit_stack_alloc specification</title>
4 </head>
5 <body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
6 <h1>pcre_jit_stack_alloc man page</h1>
7 <p>
8 Return to the <a href="index.html">PCRE index page</a>.
9 </p>
10 <p>
11 This page is part of the PCRE HTML documentation. It was generated automatically
12 from the original man page. If there is any nonsense in it, please consult the
13 man page, in case the conversion went wrong.
14 <br>
15 <br><b>
16 SYNOPSIS
17 </b><br>
18 <P>
19 <b>#include &#60;pcre.h&#62;</b>
20 </P>
21 <P>
22 <b>pcre_jit_stack *pcre_jit_stack_alloc(int <i>startsize</i>,</b>
23 <b>     int <i>maxsize</i>);</b>
24 <br>
25 <br>
26 <b>pcre16_jit_stack *pcre16_jit_stack_alloc(int <i>startsize</i>,</b>
27 <b>     int <i>maxsize</i>);</b>
28 <br>
29 <br>
30 <b>pcre32_jit_stack *pcre32_jit_stack_alloc(int <i>startsize</i>,</b>
31 <b>     int <i>maxsize</i>);</b>
32 </P>
33 <br><b>
34 DESCRIPTION
35 </b><br>
36 <P>
37 This function is used to create a stack for use by the code compiled by the JIT
38 optimization of <b>pcre[16|32]_study()</b>. The arguments are a starting size for
39 the stack, and a maximum size to which it is allowed to grow. The result can be
40 passed to the JIT run-time code by <b>pcre[16|32]_assign_jit_stack()</b>, or that
41 function can set up a callback for obtaining a stack. A maximum stack size of
42 512K to 1M should be more than enough for any pattern. For more details, see
43 the
44 <a href="pcrejit.html"><b>pcrejit</b></a>
45 page.
46 </P>
47 <P>
48 There is a complete description of the PCRE native API in the
49 <a href="pcreapi.html"><b>pcreapi</b></a>
50 page and a description of the POSIX API in the
51 <a href="pcreposix.html"><b>pcreposix</b></a>
52 page.
53 <p>
54 Return to the <a href="index.html">PCRE index page</a>.
55 </p>