PCRE2_SET_OPTIMIZE(3) Introduction to Library Functions

NAME

PCRE2 - Perl-compatible regular expressions (revised API)

SYNOPSIS

#include <pcre2.h>

int pcre2_set_optimize(pcre2_compile_context *ccontext,
uint32_t directive);

DESCRIPTION

This function controls which performance optimizations will be
applied by pcre2_compile(). It can be called multiple times with the
same compile context; the effects are cumulative, with the effects of
later calls taking precedence over earlier ones.

The result is zero for success, PCRE2_ERROR_NULL if ccontext is NULL,
or PCRE2_ERROR_BADOPTION if directive is unknown. The latter could be
useful to detect if a certain optimization is available.

The list of possible values for the directive parameter are:

PCRE2_OPTIMIZATION_FULL Enable all optimizations (default)
PCRE2_OPTIMIZATION_NONE Disable all optimizations
PCRE2_AUTO_POSSESS Enable auto-possessification
PCRE2_AUTO_POSSESS_OFF Disable auto-possessification
PCRE2_DOTSTAR_ANCHOR Enable implicit dotstar anchoring
PCRE2_DOTSTAR_ANCHOR_OFF Disable implicit dotstar anchoring
PCRE2_START_OPTIMIZE Enable start-up optimizations at match
time
PCRE2_START_OPTIMIZE_OFF Disable start-up optimizations at match
time

There is a complete description of the PCRE2 native API, including
detailed descriptions directive parameter values in the pcre2api
page.

PCRE2 10.45 22 September 2024 PCRE2_SET_OPTIMIZE(3)