blob: 703c29837c20f0cff3fb81157ce34a34c3de714f [file] [log] [blame]
Janis Danisevskis53e448c2016-03-31 13:35:25 +01001<html>
2<!-- This is a manually maintained file that is the root of the HTML version of
3 the PCRE2 documentation. When the HTML documents are built from the man
4 page versions, the entire doc/html directory is emptied, this file is then
5 copied into doc/html/index.html, and the remaining files therein are
6 created by the 132html script.
7-->
8<head>
9<title>PCRE2 specification</title>
10</head>
11<body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
12<h1>Perl-compatible Regular Expressions (revised API: PCRE2)</h1>
13<p>
14The HTML documentation for PCRE2 consists of a number of pages that are listed
15below in alphabetical order. If you are new to PCRE2, please read the first one
16first.
17</p>
18
19<table>
20<tr><td><a href="pcre2.html">pcre2</a></td>
21 <td>&nbsp;&nbsp;Introductory page</td></tr>
22
23<tr><td><a href="pcre2-config.html">pcre2-config</a></td>
24 <td>&nbsp;&nbsp;Information about the installation configuration</td></tr>
25
26<tr><td><a href="pcre2api.html">pcre2api</a></td>
27 <td>&nbsp;&nbsp;PCRE2's native API</td></tr>
28
29<tr><td><a href="pcre2build.html">pcre2build</a></td>
30 <td>&nbsp;&nbsp;Building PCRE2</td></tr>
31
32<tr><td><a href="pcre2callout.html">pcre2callout</a></td>
33 <td>&nbsp;&nbsp;The <i>callout</i> facility</td></tr>
34
35<tr><td><a href="pcre2compat.html">pcre2compat</a></td>
36 <td>&nbsp;&nbsp;Compability with Perl</td></tr>
37
38<tr><td><a href="pcre2demo.html">pcre2demo</a></td>
39 <td>&nbsp;&nbsp;A demonstration C program that uses the PCRE2 library</td></tr>
40
41<tr><td><a href="pcre2grep.html">pcre2grep</a></td>
42 <td>&nbsp;&nbsp;The <b>pcre2grep</b> command</td></tr>
43
44<tr><td><a href="pcre2jit.html">pcre2jit</a></td>
45 <td>&nbsp;&nbsp;Discussion of the just-in-time optimization support</td></tr>
46
47<tr><td><a href="pcre2limits.html">pcre2limits</a></td>
48 <td>&nbsp;&nbsp;Details of size and other limits</td></tr>
49
50<tr><td><a href="pcre2matching.html">pcre2matching</a></td>
51 <td>&nbsp;&nbsp;Discussion of the two matching algorithms</td></tr>
52
53<tr><td><a href="pcre2partial.html">pcre2partial</a></td>
54 <td>&nbsp;&nbsp;Using PCRE2 for partial matching</td></tr>
55
56<tr><td><a href="pcre2pattern.html">pcre2pattern</a></td>
57 <td>&nbsp;&nbsp;Specification of the regular expressions supported by PCRE2</td></tr>
58
59<tr><td><a href="pcre2perform.html">pcre2perform</a></td>
60 <td>&nbsp;&nbsp;Some comments on performance</td></tr>
61
62<tr><td><a href="pcre2posix.html">pcre2posix</a></td>
63 <td>&nbsp;&nbsp;The POSIX API to the PCRE2 8-bit library</td></tr>
64
65<tr><td><a href="pcre2sample.html">pcre2sample</a></td>
66 <td>&nbsp;&nbsp;Discussion of the pcre2demo program</td></tr>
67
68<tr><td><a href="pcre2serialize.html">pcre2serialize</a></td>
69 <td>&nbsp;&nbsp;Serializing functions for saving precompiled patterns</td></tr>
70
71<tr><td><a href="pcre2stack.html">pcre2stack</a></td>
72 <td>&nbsp;&nbsp;Discussion of PCRE2's stack usage</td></tr>
73
74<tr><td><a href="pcre2syntax.html">pcre2syntax</a></td>
75 <td>&nbsp;&nbsp;Syntax quick-reference summary</td></tr>
76
77<tr><td><a href="pcre2test.html">pcre2test</a></td>
78 <td>&nbsp;&nbsp;The <b>pcre2test</b> command for testing PCRE2</td></tr>
79
80<tr><td><a href="pcre2unicode.html">pcre2unicode</a></td>
81 <td>&nbsp;&nbsp;Discussion of Unicode and UTF-8/UTF-16/UTF-32 support</td></tr>
82</table>
83
84<p>
85There are also individual pages that summarize the interface for each function
86in the library.
87</p>
88
89<table>
90
91<tr><td><a href="pcre2_callout_enumerate.html">pcre2_callout_enumerate</a></td>
92 <td>&nbsp;&nbsp;Enumerate callouts in a compiled pattern</td></tr>
93
Janis Danisevskis8b979b22016-08-15 16:09:16 +010094<tr><td><a href="pcre2_code_copy.html">pcre2_code_copy</a></td>
95 <td>&nbsp;&nbsp;Copy a compiled pattern</td></tr>
96
Janis Danisevskis53e448c2016-03-31 13:35:25 +010097<tr><td><a href="pcre2_code_free.html">pcre2_code_free</a></td>
98 <td>&nbsp;&nbsp;Free a compiled pattern</td></tr>
99
100<tr><td><a href="pcre2_compile.html">pcre2_compile</a></td>
101 <td>&nbsp;&nbsp;Compile a regular expression pattern</td></tr>
102
103<tr><td><a href="pcre2_compile_context_copy.html">pcre2_compile_context_copy</a></td>
104 <td>&nbsp;&nbsp;Copy a compile context</td></tr>
105
106<tr><td><a href="pcre2_compile_context_create.html">pcre2_compile_context_create</a></td>
107 <td>&nbsp;&nbsp;Create a compile context</td></tr>
108
109<tr><td><a href="pcre2_compile_context_free.html">pcre2_compile_context_free</a></td>
110 <td>&nbsp;&nbsp;Free a compile context</td></tr>
111
112<tr><td><a href="pcre2_config.html">pcre2_config</a></td>
113 <td>&nbsp;&nbsp;Show build-time configuration options</td></tr>
114
115<tr><td><a href="pcre2_dfa_match.html">pcre2_dfa_match</a></td>
116 <td>&nbsp;&nbsp;Match a compiled pattern to a subject string
117 (DFA algorithm; <i>not</i> Perl compatible)</td></tr>
118
119<tr><td><a href="pcre2_general_context_copy.html">pcre2_general_context_copy</a></td>
120 <td>&nbsp;&nbsp;Copy a general context</td></tr>
121
122<tr><td><a href="pcre2_general_context_create.html">pcre2_general_context_create</a></td>
123 <td>&nbsp;&nbsp;Create a general context</td></tr>
124
125<tr><td><a href="pcre2_general_context_free.html">pcre2_general_context_free</a></td>
126 <td>&nbsp;&nbsp;Free a general context</td></tr>
127
128<tr><td><a href="pcre2_get_error_message.html">pcre2_get_error_message</a></td>
129 <td>&nbsp;&nbsp;Free study data</td></tr>
130
131<tr><td><a href="pcre2_get_mark.html">pcre2_get_mark</a></td>
132 <td>&nbsp;&nbsp;Get a (*MARK) name</td></tr>
133
134<tr><td><a href="pcre2_get_ovector_count.html">pcre2_get_ovector_count</a></td>
135 <td>&nbsp;&nbsp;Get the ovector count</td></tr>
136
137<tr><td><a href="pcre2_get_ovector_pointer.html">pcre2_get_ovector_pointer</a></td>
138 <td>&nbsp;&nbsp;Get a pointer to the ovector</td></tr>
139
140<tr><td><a href="pcre2_get_startchar.html">pcre2_get_startchar</a></td>
141 <td>&nbsp;&nbsp;Get the starting character offset</td></tr>
142
143<tr><td><a href="pcre2_jit_compile.html">pcre2_jit_compile</a></td>
144 <td>&nbsp;&nbsp;Process a compiled pattern with the JIT compiler</td></tr>
145
146<tr><td><a href="pcre2_jit_free_unused_memory.html">pcre2_jit_free_unused_memory</a></td>
147 <td>&nbsp;&nbsp;Free unused JIT memory</td></tr>
148
149<tr><td><a href="pcre2_jit_match.html">pcre2_jit_match</a></td>
150 <td>&nbsp;&nbsp;Fast path interface to JIT matching</td></tr>
151
152<tr><td><a href="pcre2_jit_stack_assign.html">pcre2_jit_stack_assign</a></td>
153 <td>&nbsp;&nbsp;Assign stack for JIT matching</td></tr>
154
155<tr><td><a href="pcre2_jit_stack_create.html">pcre2_jit_stack_create</a></td>
156 <td>&nbsp;&nbsp;Create a stack for JIT matching</td></tr>
157
158<tr><td><a href="pcre2_jit_stack_free.html">pcre2_jit_stack_free</a></td>
159 <td>&nbsp;&nbsp;Free a JIT matching stack</td></tr>
160
161<tr><td><a href="pcre2_maketables.html">pcre2_maketables</a></td>
162 <td>&nbsp;&nbsp;Build character tables in current locale</td></tr>
163
164<tr><td><a href="pcre2_match.html">pcre2_match</a></td>
165 <td>&nbsp;&nbsp;Match a compiled pattern to a subject string
166 (Perl compatible)</td></tr>
167
168<tr><td><a href="pcre2_match_context_copy.html">pcre2_match_context_copy</a></td>
169 <td>&nbsp;&nbsp;Copy a match context</td></tr>
170
171<tr><td><a href="pcre2_match_context_create.html">pcre2_match_context_create</a></td>
172 <td>&nbsp;&nbsp;Create a match context</td></tr>
173
174<tr><td><a href="pcre2_match_context_free.html">pcre2_match_context_free</a></td>
175 <td>&nbsp;&nbsp;Free a match context</td></tr>
176
177<tr><td><a href="pcre2_match_data_create.html">pcre2_match_data_create</a></td>
178 <td>&nbsp;&nbsp;Create a match data block</td></tr>
179
180<tr><td><a href="pcre2_match_data_create_from_pattern.html">pcre2_match_data_create_from_pattern</a></td>
181 <td>&nbsp;&nbsp;Create a match data block getting size from pattern</td></tr>
182
183<tr><td><a href="pcre2_match_data_free.html">pcre2_match_data_free</a></td>
184 <td>&nbsp;&nbsp;Free a match data block</td></tr>
185
186<tr><td><a href="pcre2_pattern_info.html">pcre2_pattern_info</a></td>
187 <td>&nbsp;&nbsp;Extract information about a pattern</td></tr>
188
189<tr><td><a href="pcre2_serialize_decode.html">pcre2_serialize_decode</a></td>
190 <td>&nbsp;&nbsp;Decode serialized compiled patterns</td></tr>
191
192<tr><td><a href="pcre2_serialize_encode.html">pcre2_serialize_encode</a></td>
193 <td>&nbsp;&nbsp;Serialize compiled patterns for save/restore</td></tr>
194
195<tr><td><a href="pcre2_serialize_free.html">pcre2_serialize_free</a></td>
196 <td>&nbsp;&nbsp;Free serialized compiled patterns</td></tr>
197
198<tr><td><a href="pcre2_serialize_get_number_of_codes.html">pcre2_serialize_get_number_of_codes</a></td>
199 <td>&nbsp;&nbsp;Get number of serialized compiled patterns</td></tr>
200
201<tr><td><a href="pcre2_set_bsr.html">pcre2_set_bsr</a></td>
202 <td>&nbsp;&nbsp;Set \R convention</td></tr>
203
204<tr><td><a href="pcre2_set_callout.html">pcre2_set_callout</a></td>
205 <td>&nbsp;&nbsp;Set up a callout function</td></tr>
206
207<tr><td><a href="pcre2_set_character_tables.html">pcre2_set_character_tables</a></td>
208 <td>&nbsp;&nbsp;Set character tables</td></tr>
209
210<tr><td><a href="pcre2_set_compile_recursion_guard.html">pcre2_set_compile_recursion_guard</a></td>
211 <td>&nbsp;&nbsp;Set up a compile recursion guard function</td></tr>
212
213<tr><td><a href="pcre2_set_match_limit.html">pcre2_set_match_limit</a></td>
214 <td>&nbsp;&nbsp;Set the match limit</td></tr>
215
216<tr><td><a href="pcre2_set_max_pattern_length.html">pcre2_set_max_pattern_length</a></td>
217 <td>&nbsp;&nbsp;Set the maximum length of pattern</td></tr>
218
219<tr><td><a href="pcre2_set_newline.html">pcre2_set_newline</a></td>
220 <td>&nbsp;&nbsp;Set the newline convention</td></tr>
221
222<tr><td><a href="pcre2_set_offset_limit.html">pcre2_set_offset_limit</a></td>
223 <td>&nbsp;&nbsp;Set the offset limit</td></tr>
224
225<tr><td><a href="pcre2_set_parens_nest_limit.html">pcre2_set_parens_nest_limit</a></td>
226 <td>&nbsp;&nbsp;Set the parentheses nesting limit</td></tr>
227
228<tr><td><a href="pcre2_set_recursion_limit.html">pcre2_set_recursion_limit</a></td>
229 <td>&nbsp;&nbsp;Set the match recursion limit</td></tr>
230
231<tr><td><a href="pcre2_set_recursion_memory_management.html">pcre2_set_recursion_memory_management</a></td>
232 <td>&nbsp;&nbsp;Set match recursion memory management</td></tr>
233
234<tr><td><a href="pcre2_substitute.html">pcre2_substitute</a></td>
235 <td>&nbsp;&nbsp;Match a compiled pattern to a subject string and do
236 substitutions</td></tr>
237
238<tr><td><a href="pcre2_substring_copy_byname.html">pcre2_substring_copy_byname</a></td>
239 <td>&nbsp;&nbsp;Extract named substring into given buffer</td></tr>
240
241<tr><td><a href="pcre2_substring_copy_bynumber.html">pcre2_substring_copy_bynumber</a></td>
242 <td>&nbsp;&nbsp;Extract numbered substring into given buffer</td></tr>
243
244<tr><td><a href="pcre2_substring_free.html">pcre2_substring_free</a></td>
245 <td>&nbsp;&nbsp;Free extracted substring</td></tr>
246
247<tr><td><a href="pcre2_substring_get_byname.html">pcre2_substring_get_byname</a></td>
248 <td>&nbsp;&nbsp;Extract named substring into new memory</td></tr>
249
250<tr><td><a href="pcre2_substring_get_bynumber.html">pcre2_substring_get_bynumber</a></td>
251 <td>&nbsp;&nbsp;Extract numbered substring into new memory</td></tr>
252
253<tr><td><a href="pcre2_substring_length_byname.html">pcre2_substring_length_byname</a></td>
254 <td>&nbsp;&nbsp;Find length of named substring</td></tr>
255
256<tr><td><a href="pcre2_substring_length_bynumber.html">pcre2_substring_length_bynumber</a></td>
257 <td>&nbsp;&nbsp;Find length of numbered substring</td></tr>
258
259<tr><td><a href="pcre2_substring_list_free.html">pcre2_substring_list_free</a></td>
260 <td>&nbsp;&nbsp;Free list of extracted substrings</td></tr>
261
262<tr><td><a href="pcre2_substring_list_get.html">pcre2_substring_list_get</a></td>
263 <td>&nbsp;&nbsp;Extract all substrings into new memory</td></tr>
264
265<tr><td><a href="pcre2_substring_nametable_scan.html">pcre2_substring_nametable_scan</a></td>
266 <td>&nbsp;&nbsp;Find table entries for given string name</td></tr>
267
268<tr><td><a href="pcre2_substring_number_from_name.html">pcre2_substring_number_from_name</a></td>
269 <td>&nbsp;&nbsp;Convert captured string name to number</td></tr>
270</table>
271
272</html>
273