Linux Manuals session 3

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_substring_copy_bynumber(pcre2_match_data *match_data, uint32_t number, PCRE2_UCHAR *buffer, PCRE2_SIZE *bufflen); Description This is a convenience function for extracting a captured substring into a given buffer. The arguments are:   match_data    The match data block for the match   number        Number of the required substring   buffer        Buffer to receive the string   bufflen       Length…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_substring_copy_byname(pcre2_match_data *match_data, PCRE2_SPTR name, PCRE2_UCHAR *buffer, PCRE2_SIZE *bufflen); Description This is a convenience function for extracting a captured substring, identified by name, into a given buffer. The arguments are:   match_data    The match data block for the match   name          Name of the required substring   buffer        Buffer to receive…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_substitute(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, PCRE2_SPTR replacement, PCRE2_SIZE rlength, PCRE2_UCHAR *outputbuffer, PCRE2_SIZE *outlengthptr); Description This function matches a compiled regular expression against a given subject string, using a matching algorithm that is similar to…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_substitute_callout(pcre2_match_context *mcontext, int (*callout_function)(pcre2_substitute_callout_block *), void *callout_data); Description This function sets the substitute 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…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_recursion_memory_management( pcre2_match_context *mcontext, void *(*private_malloc)(PCRE2_SIZE, void *), void (*private_free)(void *, void *), void *memory_data); Description From release 10.30 onwards, this function is obsolete and does nothing. The result is always zero. There is a complete description of the PCRE2 native API in the pcre2api…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_recursion_limit(pcre2_match_context *mcontext, uint32_t value); Description This function is obsolete and should not be used in new code. Use pcre2_set_depth_limit() instead. There is a complete description of the PCRE2 native API in the pcre2api page and a description of the POSIX API in the pcre2posix…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_parens_nest_limit(pcre2_compile_context *ccontext, uint32_t value); Description This function sets, in a compile context, the maximum depth of nested parentheses in a pattern. The result is always zero. There is a complete description of the PCRE2 native API in the pcre2api page and a description of…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_offset_limit(pcre2_match_context *mcontext, PCRE2_SIZE value); Description This function sets the offset 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 the…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_newline(pcre2_compile_context *ccontext, uint32_t value); Description This function sets the newline convention within a compile context. This specifies which character(s) are recognized as newlines when compiling and matching patterns. The second argument must be one of: The result is zero for success or PCRE2_ERROR_BADDATA if…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_max_pattern_length(pcre2_compile_context *ccontext, PCRE2_SIZE value); Description This function sets, in a compile context, the maximum text length (in code units) of the pattern that can be compiled. The result is always zero. If a longer pattern is passed to pcre2_compile() there is an immediate error…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_match_limit(pcre2_match_context *mcontext, uint32_t value); Description This function sets the match 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 the…

PCRE2 – Perl-compatible regular expressions (revised API) Synopsis #include <pcre2.h> int pcre2_set_heap_limit(pcre2_match_context *mcontext, uint32_t value); Description This function sets the backtracking heap 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_glob_separator(pcre2_convert_context *cvcontext, uint32_t separator_char); Description This function is part of an experimental set of pattern conversion functions. It sets the component separator character that is used when converting globs. The second argument must be one of the characters forward slash, backslash, or dot. The…

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…