1 .TH PCRE_CONFIG 3 "20 April 2014" "PCRE 8.36"
3 PCRE - Perl-compatible regular expressions
10 .B int pcre_config(int \fIwhat\fP, void *\fIwhere\fP);
12 .B int pcre16_config(int \fIwhat\fP, void *\fIwhere\fP);
14 .B int pcre32_config(int \fIwhat\fP, void *\fIwhere\fP);
19 This function makes it possible for a client program to find out which optional
20 features are available in the version of the PCRE library it is using. The
21 arguments are as follows:
23 \fIwhat\fP A code specifying what information is required
24 \fIwhere\fP Points to where to put the data
26 The \fIwhere\fP argument must point to an integer variable, except for
27 PCRE_CONFIG_MATCH_LIMIT, PCRE_CONFIG_MATCH_LIMIT_RECURSION, and
28 PCRE_CONFIG_PARENS_LIMIT, when it must point to an unsigned long integer,
29 and for PCRE_CONFIG_JITTARGET, when it must point to a const char*.
30 The available codes are:
32 PCRE_CONFIG_JIT Availability of just-in-time compiler
34 PCRE_CONFIG_JITTARGET String containing information about the
35 target architecture for the JIT compiler,
36 or NULL if there is no JIT support
37 PCRE_CONFIG_LINK_SIZE Internal link size: 2, 3, or 4
38 PCRE_CONFIG_PARENS_LIMIT Parentheses nesting limit
39 PCRE_CONFIG_MATCH_LIMIT Internal resource limit
40 PCRE_CONFIG_MATCH_LIMIT_RECURSION
41 Internal recursion depth limit
42 PCRE_CONFIG_NEWLINE Value of the default newline sequence:
45 3338 (0x0d0a) for CRLF
48 PCRE_CONFIG_BSR Indicates what \eR matches by default:
49 0 all Unicode line endings
50 1 CR, LF, or CRLF only
51 PCRE_CONFIG_POSIX_MALLOC_THRESHOLD
52 Threshold of return slots, above which
53 \fBmalloc()\fP is used by the POSIX API
54 PCRE_CONFIG_STACKRECURSE Recursion implementation (1=stack 0=heap)
55 PCRE_CONFIG_UTF16 Availability of UTF-16 support (1=yes
56 0=no); option for \fBpcre16_config()\fP
57 PCRE_CONFIG_UTF32 Availability of UTF-32 support (1=yes
58 0=no); option for \fBpcre32_config()\fP
59 PCRE_CONFIG_UTF8 Availability of UTF-8 support (1=yes 0=no);
60 option for \fBpcre_config()\fP
61 PCRE_CONFIG_UNICODE_PROPERTIES
62 Availability of Unicode property support
65 The function yields 0 on success or PCRE_ERROR_BADOPTION otherwise. That error
66 is also given if PCRE_CONFIG_UTF16 or PCRE_CONFIG_UTF32 is passed to
67 \fBpcre_config()\fP, if PCRE_CONFIG_UTF8 or PCRE_CONFIG_UTF32 is passed to
68 \fBpcre16_config()\fP, or if PCRE_CONFIG_UTF8 or PCRE_CONFIG_UTF16 is passed to
69 \fBpcre32_config()\fP.
71 There is a complete description of the PCRE native API in the
75 page and a description of the POSIX API in the