3 <title>pcre_config specification</title>
5 <body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
6 <h1>pcre_config man page</h1>
8 Return to the <a href="index.html">PCRE index page</a>.
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.
19 <b>#include <pcre.h></b>
22 <b>int pcre_config(int <i>what</i>, void *<i>where</i>);</b>
25 <b>int pcre16_config(int <i>what</i>, void *<i>where</i>);</b>
28 <b>int pcre32_config(int <i>what</i>, void *<i>where</i>);</b>
34 This function makes it possible for a client program to find out which optional
35 features are available in the version of the PCRE library it is using. The
36 arguments are as follows:
38 <i>what</i> A code specifying what information is required
39 <i>where</i> Points to where to put the data
41 The <i>where</i> argument must point to an integer variable, except for
42 PCRE_CONFIG_MATCH_LIMIT and PCRE_CONFIG_MATCH_LIMIT_RECURSION, when it must
43 point to an unsigned long integer. The available codes are:
45 PCRE_CONFIG_JIT Availability of just-in-time compiler
47 PCRE_CONFIG_JITTARGET String containing information about the
48 target architecture for the JIT compiler,
49 or NULL if there is no JIT support
50 PCRE_CONFIG_LINK_SIZE Internal link size: 2, 3, or 4
51 PCRE_CONFIG_PARENS_LIMIT Parentheses nesting limit
52 PCRE_CONFIG_MATCH_LIMIT Internal resource limit
53 PCRE_CONFIG_MATCH_LIMIT_RECURSION
54 Internal recursion depth limit
55 PCRE_CONFIG_NEWLINE Value of the default newline sequence:
58 3338 (0x0d0a) for CRLF
61 PCRE_CONFIG_BSR Indicates what \R matches by default:
62 0 all Unicode line endings
63 1 CR, LF, or CRLF only
64 PCRE_CONFIG_POSIX_MALLOC_THRESHOLD
65 Threshold of return slots, above which
66 <b>malloc()</b> is used by the POSIX API
67 PCRE_CONFIG_STACKRECURSE Recursion implementation (1=stack 0=heap)
68 PCRE_CONFIG_UTF16 Availability of UTF-16 support (1=yes
69 0=no); option for <b>pcre16_config()</b>
70 PCRE_CONFIG_UTF32 Availability of UTF-32 support (1=yes
71 0=no); option for <b>pcre32_config()</b>
72 PCRE_CONFIG_UTF8 Availability of UTF-8 support (1=yes 0=no);
73 option for <b>pcre_config()</b>
74 PCRE_CONFIG_UNICODE_PROPERTIES
75 Availability of Unicode property support
78 The function yields 0 on success or PCRE_ERROR_BADOPTION otherwise. That error
79 is also given if PCRE_CONFIG_UTF16 or PCRE_CONFIG_UTF32 is passed to
80 <b>pcre_config()</b>, if PCRE_CONFIG_UTF8 or PCRE_CONFIG_UTF32 is passed to
81 <b>pcre16_config()</b>, or if PCRE_CONFIG_UTF8 or PCRE_CONFIG_UTF16 is passed to
82 <b>pcre32_config()</b>.
85 There is a complete description of the PCRE native API in the
86 <a href="pcreapi.html"><b>pcreapi</b></a>
87 page and a description of the POSIX API in the
88 <a href="pcreposix.html"><b>pcreposix</b></a>
91 Return to the <a href="index.html">PCRE index page</a>.