PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_convert_context *pcre2_convert_context_create( pcre2_general_context *gcontext); Description This function is part of an experimental set of pattern conversion functions. It creates and initializes a new convert context. If its argument is NULL, malloc() is used to get the necessary memory; otherwise the memory allocation function within the…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_convert_context *pcre2_convert_context_copy( pcre2_convert_context *cvcontext); Description This function is part of an experimental set of pattern conversion functions. It makes a new copy of a convert context, using the memory allocation function that was used for the original context. The result is NULL if the memory…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_config(uint32_t what, void *where); Description This function makes it possible for a client program to find out which optional features are available in the version of the PCRE2 library it is using. The arguments are as follows: what A code specifying what information is required…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> void pcre2_compile_context_free(pcre2_compile_context *ccontext); Description This function frees the memory occupied by a compile context, using the memory freeing function from the general context with which it was created, or free() if that was not set. If the argument is NULL, the function returns immediately without…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_compile_context *pcre2_compile_context_create( pcre2_general_context *gcontext); Description This function creates and initializes a new compile context. If its argument is NULL, malloc() is used to get the necessary memory; otherwise the memory allocation function within the general context is used. The result is NULL if the memory…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_compile_context *pcre2_compile_context_copy( pcre2_compile_context *ccontext); Description This function makes a new copy of a compile context, using the memory allocation function that was used for the original context. The result is NULL if the memory cannot be obtained. There is a complete description of the PCRE2…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_code *pcre2_compile(PCRE2_SPTR pattern, PCRE2_SIZE length, uint32_t options, int *errorcode, PCRE2_SIZE *erroroffset, pcre2_compile_context *ccontext); Description This function compiles a regular expression pattern into an internal form. Its arguments are: pattern A string containing expression to be compiled length The length of the string or PCRE2_ZERO_TERMINATED options Option bits errorcode Where…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> void pcre2_code_free(pcre2_code *code); Description If code is NULL, this function does nothing. Otherwise, code must point to a compiled pattern. This function frees its memory, including any memory used by the JIT compiler. If the compiled pattern was created by a call to pcre2_code_copy_with_tables(), the…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_code *pcre2_code_copy_with_tables(const pcre2_code *code); Description This function makes a copy of the memory used for a compiled pattern, excluding any memory used by the JIT compiler. Without a subsequent call to pcre2_jit_compile(), the copy can be used only for non-JIT matching. Unlike pcre2_code_copy(), a separate…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_code *pcre2_code_copy(const pcre2_code *code); Description This function makes a copy of the memory used for a compiled pattern, excluding any memory used by the JIT compiler. Without a subsequent call to pcre2_jit_compile(), the copy can be used only for non-JIT matching. The pointer to the…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_callout_enumerate(const pcre2_code *code, int (*callback)(pcre2_callout_enumerate_block *, void *), void *callout_data); Description This function scans a compiled regular expression and calls the callback() function for each callout within the pattern. The yield of the function is zero for success and non-zero otherwise. The arguments are:…
PCRE2 – Perl-compatible regular expressions (revised API) Introduction PCRE2 is the name used for a revised API for the PCRE library, which is a set of functions, written in C, that implement regular expression pattern matching using the same syntax and semantics as Perl, with just a few differences. After nearly two decades, the limitations…
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> const char *pcre_version(void); const char *pcre16_version(void); const char *pcre32_version(void); Description This function (even in the 16-bit and 32-bit libraries) returns a zero-terminated, 8-bit character string that gives the version number of the PCRE library and the date of its release. There is a complete description of the…
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> int pcre16_utf16_to_host_byte_order(PCRE_UCHAR16 *output, PCRE_SPTR16 input, int length, int *host_byte_order, int keep_boms); Description This function, which exists only in the 16-bit library, converts a UTF-16 string to the correct order for the current host, taking account of any byte order marks (BOMs) within the string. Its arguments are:…
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> pcre_extra *pcre_study(const pcre *code, int options, const char **errptr); pcre16_extra *pcre16_study(const pcre16 *code, int options, const char **errptr); pcre32_extra *pcre32_study(const pcre32 *code, int options, const char **errptr); Description This function studies a compiled pattern, to see if additional information can be extracted that might speed up matching….
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> int pcre_refcount(pcre *code, int adjust); int pcre16_refcount(pcre16 *code, int adjust); int pcre32_refcount(pcre32 *code, int adjust); Description This function is used to maintain a reference count inside a data block that contains a compiled pattern. Its arguments are: code Compiled regular expression adjust Adjustment to reference value The yield of…
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> int pcre_pattern_to_host_byte_order(pcre *code, pcre_extra *extra, const unsigned char *tables); int pcre16_pattern_to_host_byte_order(pcre16 *code, pcre16_extra *extra, const unsigned char *tables); int pcre32_pattern_to_host_byte_order(pcre32 *code, pcre32_extra *extra, const unsigned char *tables); Description This function ensures that the bytes in 2-byte and 4-byte values in a compiled pattern are in the correct…
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> const unsigned char *pcre_maketables(void); const unsigned char *pcre16_maketables(void); const unsigned char *pcre32_maketables(void); Description This function builds a set of character tables for character values less than 256. These can be passed to pcre[16|32]_compile() to override PCRE’s internal, built-in tables (which were made by pcre[16|32]_maketables() when PCRE was…
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> void pcre_jit_stack_free(pcre_jit_stack *stack); void pcre16_jit_stack_free(pcre16_jit_stack *stack); void pcre32_jit_stack_free(pcre32_jit_stack *stack); Description This function is used to free a JIT stack that was created by pcre[16|32]_jit_stack_alloc() when it is no longer needed. For more details, see the pcrejit page. There is a complete description of the PCRE native API…
PCRE – Perl-compatible regular expressions Synopsis #include <pcre.h> pcre_jit_stack *pcre_jit_stack_alloc(int startsize, int maxsize); pcre16_jit_stack *pcre16_jit_stack_alloc(int startsize, int maxsize); pcre32_jit_stack *pcre32_jit_stack_alloc(int startsize, int maxsize); Description This function is used to create a stack for use by the code compiled by the JIT optimization of pcre[16|32]_study(). The arguments are a starting size for the stack, and a…