PCRE2_MATCH_DATA_FREE(3)

🎀 NAME 🎀

okay bestie, this is the PCRE2_MATCH_DATA_FREE(3) page from the Library Functions Manual, and it's all about PCRE2 — Perl-compatible regular expressions (revised API) — specifically the function that frees your match data. 💖

✨ SYNOPSIS ✨

#include <pcre2.h>

void pcre2_match_data_free(pcre2_match_data *match_data);

🦋 DESCRIPTION 🦋

So here's the tea: if match_data is NULL, this function does absolutely nothing. Literally a no-op, bestie. 💅

Otherwise, match_data must point to a match data block, and this function frees it. It frees it using the memory freeing function from the general context or compiled pattern with which it was created, or free() if that was not set. Slay. ✨

If the match data block was previously passed to pcre2_match(), it will have an attached heapframe vector; this is also freed. 🫶

If the PCRE2_COPY_MATCHED_SUBJECT was used for a successful match using this match data block, the copy of the subject that was referenced within the block is also freed. 😭💖

There is a complete description of the PCRE2 native API in the pcre2api page and a description of the POSIX API in the pcre2posix page. 👑

---

that's the whole vibe, bestie — this manual page is from PCRE2 10.47, dated 16 August 2023, and we are so done here. periodt. 💜