PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_glob_escape(pcre2_convert_context *cvcontext, uint32_t escape_char); Description This function is part of an experimental set of pattern conversion functions. It sets the escape character that is used when converting globs. The second argument must either be zero (meaning there is no escape character) or a punctuation…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_depth_limit(pcre2_match_context *mcontext, uint32_t value); Description This function sets the backtracking depth limit field in a match context. The result is always zero. There is a complete description of the PCRE2 native API in the pcre2api page and a description of the POSIX API in…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_compile_recursion_guard(pcre2_compile_context *ccontext, int (*guard_function)(uint32_t, void *), void *user_data); Description This function defines, within a compile context, a function that is called whenever pcre2_compile() starts to compile a parenthesized part of a pattern. The first argument to the function gives the current depth of parenthesis…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_compile_extra_options(pcre2_compile_context *ccontext, uint32_t extra_options); Description This function sets additional option bits for pcre2_compile() that are housed in a compile context. It completely replaces all the bits. The extra options are: There is a complete description of the PCRE2 native API in the pcre2api page…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_character_tables(pcre2_compile_context *ccontext, const uint8_t *tables); Description This function sets a pointer to custom character tables within a compile context. The second argument must be the result of a call to pcre2_maketables() or NULL to request the default tables. The result is always zero. There…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_callout(pcre2_match_context *mcontext, int (*callout_function)(pcre2_callout_block *), void *callout_data); Description This function sets the callout fields in a match context (the first argument). The second argument specifies a callout function, and the third argument is an opaque data item that is passed to it. The result…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_bsr(pcre2_compile_context *ccontext, uint32_t value); Description This function sets the convention for processing \R within a compile context. The second argument must be one of PCRE2_BSR_ANYCRLF or PCRE2_BSR_UNICODE. The result is zero for success or PCRE2_ERROR_BADDATA if the second argument is invalid. There is a…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int32_t pcre2_serialize_get_number_of_codes(const uint8_t *bytes); Description The bytes argument must point to a serialized byte stream that was originally created by pcre2_serialize_encode() (though it may have been saved on disc or elsewhere in the meantime). The function returns the number of serialized patterns in the byte…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> void pcre2_serialize_free(uint8_t *bytes); Description This function frees the memory that was obtained by pcre2_serialize_encode() to hold a serialized byte stream. The argument must point to such a byte stream or be NULL, in which case the function returns without doing anything. There is a complete…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int32_t pcre2_serialize_encode(const pcre2_code **codes, int32_t number_of_codes, uint8_t **serialized_bytes, PCRE2_SIZE *serialized_size, pcre2_general_context *gcontext); Description This function encodes a list of compiled patterns into a byte stream that can be saved on disc or elsewhere. Note that this is not an abstract format like Java or .NET….
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int32_t pcre2_serialize_decode(pcre2_code **codes, int32_t number_of_codes, const uint8_t *bytes, pcre2_general_context *gcontext); Description This function decodes a serialized set of compiled patterns back into a list of individual patterns. This is possible only on a host that is running the same version of PCRE2, with the same…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_pattern_info(const pcre2_code *code, uint32_t what, void *where); Description This function returns information about a compiled pattern. Its arguments are: code Pointer to a compiled regular expression pattern what What information is required where Where to put the information The recognized values for the what argument, and the…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_pattern_convert(PCRE2_SPTR pattern, PCRE2_SIZE length, uint32_t options, PCRE2_UCHAR **buffer, PCRE2_SIZE *blength, pcre2_convert_context *cvcontext); Description This function is part of an experimental set of pattern conversion functions. It converts a foreign pattern (for example, a glob) into a PCRE2 regular expression pattern. Its arguments are: pattern The…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> void pcre2_match_data_free(pcre2_match_data *match_data); Description If match_data is NULL, this function does nothing. Otherwise, match_data must point to a match data block, which this function frees, using the memory freeing function from the general context or compiled pattern with which it was created, or free() if…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_match_data *pcre2_match_data_create_from_pattern( const pcre2_code *code, pcre2_general_context *gcontext); Description This function creates a new match data block, which is used for holding the result of a match. The first argument points to a compiled pattern. The number of capturing parentheses within the pattern is used to…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> pcre2_match_data *pcre2_match_data_create(uint32_t ovecsize, pcre2_general_context *gcontext); Description This function creates a new match data block, which is used for holding the result of a match. The first argument specifies the number of pairs of offsets that are required. These form the "output vector" (ovector) within the…
PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> void pcre2_match_context_free(pcre2_match_context *mcontext); Description This function frees the memory occupied by a match 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_match_context *pcre2_match_context_create( pcre2_general_context *gcontext); Description This function creates and initializes a new match 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_match_context *pcre2_match_context_copy( pcre2_match_context *mcontext); Description This function makes a new copy of a match 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> int pcre2_match(const pcre2_code *code, PCRE2_SPTR subject, PCRE2_SIZE length, PCRE2_SIZE startoffset, uint32_t options, pcre2_match_data *match_data, pcre2_match_context *mcontext); Description This function matches a compiled regular expression against a given subject string, using a matching algorithm that is similar to Perl’s. It returns offsets to what it has…