1PCRE2_CONFIG(3)            Library Functions Manual            PCRE2_CONFIG(3)
2
3
4

NAME

6       PCRE2 - Perl-compatible regular expressions (revised API)
7

SYNOPSIS

9
10       #include <pcre2.h>
11
12       int pcre2_config(uint32_t what, void *where);
13

DESCRIPTION

15
16       This  function makes it possible for a client program to find out which
17       optional features are available in the version of the PCRE2 library  it
18       is using. The arguments are as follows:
19
20         what     A code specifying what information is required
21         where    Points to where to put the information
22
23       If  where is NULL, the function returns the amount of memory needed for
24       the requested information. When the information is a string, the  value
25       is in code units; for other types of data it is in bytes.
26
27       If  where  is  not  NULL, for PCRE2_CONFIG_JITTARGET, PCRE2_CONFIG_UNI‐
28       CODE_VERSION, and PCRE2_CONFIG_VERSION it must point to a  buffer  that
29       is  large  enough to hold the string. For all other codes it must point
30       to a uint32_t integer variable. The available codes are:
31
32         PCRE2_CONFIG_BSR             Indicates what \R matches by default:
33                                        PCRE2_BSR_UNICODE
34                                        PCRE2_BSR_ANYCRLF
35         PCRE2_CONFIG_JIT             Availability of just-in-time compiler
36                                       support (1=yes 0=no)
37         PCRE2_CONFIG_JITTARGET       Information about the target archi-
38                                        tecture for the JIT compiler
39         PCRE2_CONFIG_LINKSIZE        Configured internal link size (2, 3, 4)
40         PCRE2_CONFIG_MATCHLIMIT      Default internal resource limit
41         PCRE2_CONFIG_NEWLINE         Code for the default newline sequence:
42                                        PCRE2_NEWLINE_CR
43                                        PCRE2_NEWLINE_LF
44                                        PCRE2_NEWLINE_CRLF
45                                        PCRE2_NEWLINE_ANY
46                                        PCRE2_NEWLINE_ANYCRLF
47         PCRE2_CONFIG_PARENSLIMIT     Default parentheses nesting limit
48         PCRE2_CONFIG_RECURSIONLIMIT  Internal recursion depth limit
49         PCRE2_CONFIG_STACKRECURSE    Recursion implementation (1=stack
50                                        0=heap)
51         PCRE2_CONFIG_UNICODE         Availability of Unicode support (1=yes
52                                        0=no)
53         PCRE2_CONFIG_UNICODE_VERSION The Unicode version (a string)
54         PCRE2_CONFIG_VERSION         The PCRE2 version (a string)
55
56       The function yields a non-negative value on  success  or  the  negative
57       value  PCRE2_ERROR_BADOPTION otherwise. This is also the result for the
58       PCRE2_CONFIG_JITTARGET code if JIT support is  not  available.  When  a
59       string  is  requested,  the  function  returns the number of code units
60       used, including the terminating zero.
61
62       There is a complete description of the PCRE2 native API in the pcre2api
63       page and a description of the POSIX API in the pcre2posix page.
64
65
66
67PCRE2 10.0                       20 April 2014                 PCRE2_CONFIG(3)
Impressum