PCRE2_SET_OPTIMIZE(3)

📦
version 10.49 · 4 versions
, in alpine 3.23, alpine 3.24, arch rolling

💅 pcre2_set_optimize(3) — aka the PCRE2 glow-up page

okay so first things first, bestie: the manual name here is PCRE2 — Perl-compatible regular expressions (revised API). And the function we're stanning today is pcre2_set_optimize. It lives in the Library Functions Manual. She's a library function. She's iconic. Let's get into it. ✨

🌸 NAME 🌸

PCRE2 — Perl-compatible regular expressions (revised API)

🎀 SYNOPSIS 🎀

#include <pcre2.h>

int pcre2_set_optimize(pcre2_compile_context *ccontext,
  uint32_t directive);

like. look at her. two arguments. one context, one directive, returns an int. no cap. 🫶

✨ DESCRIPTION ✨

so basically this function is the vibe control for performance optimizations. It decides which optimizations pcre2_compile() is gonna apply. 🧚

Here's the cute part: you can call it multiple times on the same compile context. The effects are cumulative, and if there's a conflict, the effects of later calls take precedence over earlier ones. So yeah, last word wins. main character energy honestly. 👑

🌈 what you get back 🌈

The result is:

  • zero for success 💖
  • PCRE2_ERROR_NULL if ccontext is NULL 💀
  • PCRE2_ERROR_BADOPTION if directive is unknown 🙈

ngl that last one is lowkey useful — you can use it to detect whether a certain optimization is even available. like a little vibe check for features. iykyk. 🦋

🌟 the directive values, bestie 🌟

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 💜
and if you want the full lore, there's a complete description of the PCRE2 native API, including detailed descriptions of the directive parameter values, over in the pcre2api page. go read her. she ate. 📖✨

mwah, that's the whole page. thanks for coming to my ted talk. 💖

signing off from the PCRE2 10.49 era, dated 22 September 2024 — this was PCRE2_SET_OPTIMIZE(3), and she slayed. periodt. 💅🌈

📦 where this page comes from