pcre2_set_optimize

Manual page for PCRE2 10.50-DEV

Name

pcre2_set_optimize - set an optimization directive

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 of directive parameter values, in the pcre2api page.