pcre2_pattern_convert(3) — Linux manual page
PCRE2_PA...N_CONVERT(3) Library Functions Manual PCRE2_PA...N_CONVERT(3)
NAME
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 foreign pattern
length The length of the input pattern or
PCRE2_ZERO_TERMINATED
options Option bits
buffer Pointer to pointer to output buffer, or NULL
blength Pointer to output length field
cvcontext Pointer to a convert context or NULL
The length of the converted pattern (excluding the terminating
zero) is returned via blength. If buffer is NULL, the function
just returns the output length. If buffer points to a NULL
pointer, heap memory is obtained for the converted pattern, using
the allocator in the context if present (or else malloc()), and
the field pointed to by buffer is updated. If buffer points to a
non-NULL field, that must point to a buffer whose size is in the
variable pointed to by blength. This value is updated.
The option bits are:
PCRE2_CONVERT_UTF Input is UTF
PCRE2_CONVERT_NO_UTF_CHECK Do not check UTF validity
PCRE2_CONVERT_POSIX_BASIC Convert POSIX basic
pattern
PCRE2_CONVERT_POSIX_EXTENDED Convert POSIX extended
pattern
PCRE2_CONVERT_GLOB ) Convert
PCRE2_CONVERT_GLOB_NO_WILD_SEPARATOR ) various types
PCRE2_CONVERT_GLOB_NO_STARSTAR ) of glob
The return value from pcre2_pattern_convert() is zero on success
or a non-zero PCRE2 error code.
The pattern conversion functions are described in the
pcre2convert documentation.
COLOPHON
This page is part of the PCRE (Perl Compatible Regular
Expressions) project. Information about the project can be found
at ⟨http://www.pcre.org/⟩. If you have a bug report for this
manual page, see
⟨http://bugs.exim.org/enter_bug.cgi?product=PCRE⟩. This page was
obtained from the tarball fetched from
⟨https://github.com/PhilipHazel/pcre2.git⟩ on 2024-06-14. If you
discover any rendering problems in this HTML version of the page,
or you believe there is a better or more up-to-date source for
the page, or you have corrections or improvements to the
information in this COLOPHON (which is not part of the original
manual page), send a mail to man-pages@man7.org