carta
pcre2_match_data_free(3)

pcre2_match_data_free3

Perl-compatible regular expressions (revised api)

Usage

void pcre2_match_data_free(pcre2_match_data *match_data);

Overview

If match_data is NULL, this function does nothing. Otherwise, match_data must point to a match data block, which this function frees, using the memory freeing function from the general context or compiled pattern with which it was created, or free() if that was not set. 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.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm) to Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)

From pcre2 10.49-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.