Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

pcre2_pattern_convert (3)

Name

pcre2_pattern_convert - 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

PCRE2_PATTERN_CONVERT(3)   Library Functions Manual   PCRE2_PATTERN_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 doc-
       umentation.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/pcre2    |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source     was     downloaded     from       https://github.com/Philip-
       Hazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.tar.gz.

       Further information about this software can be found on the open source
       community website at http://pcre.org/.



PCRE2 10.30                      11 July 2017         PCRE2_PATTERN_CONVERT(3)