1PCRE_CONFIG(3) Library Functions Manual PCRE_CONFIG(3)
2
6 PCRE - Perl-compatible regular expressions
7
9 #include <pcre.h>
11 int pcre_config(int what, void *where);
13 int pcre16_config(int what, void *where);
15 int pcre32_config(int what, void *where);
17
19 This function makes it possible for a client program to find out which
21 optional features are available in the version of the PCRE library it
22 is using. The arguments are as follows:
23 what A code specifying what information is required
25 where Points to where to put the data
26 The where argument must point to an integer variable, except for
28 PCRE_CONFIG_MATCH_LIMIT, PCRE_CONFIG_MATCH_LIMIT_RECURSION, and
29 PCRE_CONFIG_PARENS_LIMIT, when it must point to an unsigned long inte‐
30 ger, and for PCRE_CONFIG_JITTARGET, when it must point to a const
31 char*. The available codes are:
32 PCRE_CONFIG_JIT Availability of just-in-time compiler
34 support (1=yes 0=no)
35 PCRE_CONFIG_JITTARGET String containing information about the
36 target architecture for the JIT compiler,
37 or NULL if there is no JIT support
38 PCRE_CONFIG_LINK_SIZE Internal link size: 2, 3, or 4
39 PCRE_CONFIG_PARENS_LIMIT Parentheses nesting limit
40 PCRE_CONFIG_MATCH_LIMIT Internal resource limit
41 PCRE_CONFIG_MATCH_LIMIT_RECURSION
42 Internal recursion depth limit
43 PCRE_CONFIG_NEWLINE Value of the default newline sequence:
44 13 (0x000d) for CR
45 10 (0x000a) for LF
46 3338 (0x0d0a) for CRLF
47 -2 for ANYCRLF
48 -1 for ANY
49 PCRE_CONFIG_BSR Indicates what \R matches by default:
50 0 all Unicode line endings
51 1 CR, LF, or CRLF only
52 PCRE_CONFIG_POSIX_MALLOC_THRESHOLD
53 Threshold of return slots, above which
54 malloc() is used by the POSIX API
55 PCRE_CONFIG_STACKRECURSE Recursion implementation (1=stack 0=heap)
56 PCRE_CONFIG_UTF16 Availability of UTF-16 support (1=yes
57 0=no); option for pcre16_config()
58 PCRE_CONFIG_UTF32 Availability of UTF-32 support (1=yes
59 0=no); option for pcre32_config()
60 PCRE_CONFIG_UTF8 Availability of UTF-8 support (1=yes 0=no);
61 option for pcre_config()
62 PCRE_CONFIG_UNICODE_PROPERTIES
63 Availability of Unicode property support
64 (1=yes 0=no)
65 The function yields 0 on success or PCRE_ERROR_BADOPTION otherwise.
67 That error is also given if PCRE_CONFIG_UTF16 or PCRE_CONFIG_UTF32 is
68 passed to pcre_config(), if PCRE_CONFIG_UTF8 or PCRE_CONFIG_UTF32 is
69 passed to pcre16_config(), or if PCRE_CONFIG_UTF8 or PCRE_CONFIG_UTF16
70 is passed to pcre32_config().
71 There is a complete description of the PCRE native API in the pcreapi
73 page and a description of the POSIX API in the pcreposix page.
74PCRE 8.36 20 April 2014 PCRE_CONFIG(3)