PCRE2_NEXT_MATCH(3)	    Library Functions Manual	     PCRE2_NEXT_MATCH(3)

NAME
     PCRE2 - Perl-compatible regular expressions (revised API)

SYNOPSIS

     #include <pcre2.h>

     int pcre2_next_match(pcre2_match_data *match_data,
       PCRE2_SIZE *pstart_offset, uint32_t *poptions);

DESCRIPTION

     This   function   can   be	  called   after  one  of  the	match  functions
     (pcre2_match(), pcre2_dfa_match(), or pcre2_jit_match()), and must be  pro-
     vided  with the same match_data parameter. It outputs the appropriate para-
     meters for searching for the next match in the same subject string, and  is
     suitable  for applications providing "global" matching behaviour (for exam-
     ple, replacing all matches in the subject, or splitting the subject on  all
     matches, or simply counting the number of matches).

     It	 returns  0  ("false") if there is no need to make any further match at-
     tempts, or 1 ("true") if another match should be attempted.

     The *pstart_offset and *poptions are set if the function  returns	1.   The
     *pstart_offset should be passed to the next match attempt directly, and the
     *poptions	should be passed to the next match attempt by combining with the
     application's match options using OR.

     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.

PCRE2 10.48			  24 March 2025		     PCRE2_NEXT_MATCH(3)