FreeBSD Manual Pages
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.47 24 March 2025 PCRE2_NEXT_MATCH(3)
NAME | SYNOPSIS | DESCRIPTION
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pcre2_next_match&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>