PCRE2Project · NWilson · Mar 24, 2025 · Mar 13, 2025 · Mar 19, 2025 · Mar 19, 2025
diff --git a/BUILD.bazel b/BUILD.bazel
@@ -80,6 +80,7 @@ cc_library(
         "src/pcre2_maketables.c",
         "src/pcre2_match.c",
         "src/pcre2_match_data.c",
+        "src/pcre2_match_next.c",
         "src/pcre2_newline.c",
         "src/pcre2_ord2utf.c",
         "src/pcre2_pattern_info.c",

diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -782,6 +782,7 @@ set(
   src/pcre2_maketables.c
   src/pcre2_match.c
   src/pcre2_match_data.c
+  src/pcre2_match_next.c
   src/pcre2_newline.c
   src/pcre2_ord2utf.c
   src/pcre2_pattern_info.c

diff --git a/Makefile.am b/Makefile.am
@@ -73,6 +73,7 @@ dist_html_DATA = \
   doc/html/pcre2_match_data_create.html \
   doc/html/pcre2_match_data_create_from_pattern.html \
   doc/html/pcre2_match_data_free.html \
+  doc/html/pcre2_next_match.html \
   doc/html/pcre2_pattern_convert.html \
   doc/html/pcre2_pattern_info.html \
   doc/html/pcre2_serialize_decode.html \
@@ -174,6 +175,7 @@ dist_man_MANS = \
   doc/pcre2_match_data_create.3 \
   doc/pcre2_match_data_create_from_pattern.3 \
   doc/pcre2_match_data_free.3 \
+  doc/pcre2_next_match.3 \
   doc/pcre2_pattern_convert.3 \
   doc/pcre2_pattern_info.3 \
   doc/pcre2_serialize_decode.3 \
@@ -419,6 +421,7 @@ COMMON_SOURCES = \
   src/pcre2_maketables.c \
   src/pcre2_match.c \
   src/pcre2_match_data.c \
+  src/pcre2_match_next.c \
   src/pcre2_newline.c \
   src/pcre2_ord2utf.c \
   src/pcre2_pattern_info.c \

diff --git a/NON-AUTOTOOLS-BUILD b/NON-AUTOTOOLS-BUILD
@@ -120,6 +120,7 @@ example.
        pcre2_maketables.c
        pcre2_match.c
        pcre2_match_data.c
+       pcre2_match_next.c
        pcre2_newline.c
        pcre2_ord2utf.c
        pcre2_pattern_info.c

diff --git a/README b/README
@@ -866,6 +866,7 @@ The distribution should contain the files listed below.
   src/pcre2_maketables.c     ) sources for the functions in the library,
   src/pcre2_match.c          )   and some internal functions that they use
   src/pcre2_match_data.c     )
+  src/pcre2_match_next.c     )
   src/pcre2_newline.c        )
   src/pcre2_ord2utf.c        )
   src/pcre2_pattern_info.c   )

diff --git a/build.zig b/build.zig
@@ -92,6 +92,7 @@ pub fn build(b: *std.Build) !void {
             "src/pcre2_maketables.c",
             "src/pcre2_match.c",
             "src/pcre2_match_data.c",
+            "src/pcre2_match_next.c",
             "src/pcre2_newline.c",
             "src/pcre2_ord2utf.c",
             "src/pcre2_pattern_info.c",

diff --git a/doc/html/NON-AUTOTOOLS-BUILD.txt b/doc/html/NON-AUTOTOOLS-BUILD.txt
@@ -120,6 +120,7 @@ example.
        pcre2_maketables.c
        pcre2_match.c
        pcre2_match_data.c
+       pcre2_match_next.c
        pcre2_newline.c
        pcre2_ord2utf.c
        pcre2_pattern_info.c

diff --git a/doc/html/README.txt b/doc/html/README.txt
@@ -866,6 +866,7 @@ The distribution should contain the files listed below.
   src/pcre2_maketables.c     ) sources for the functions in the library,
   src/pcre2_match.c          )   and some internal functions that they use
   src/pcre2_match_data.c     )
+  src/pcre2_match_next.c     )
   src/pcre2_newline.c        )
   src/pcre2_ord2utf.c        )
   src/pcre2_pattern_info.c   )

diff --git a/doc/html/index.html b/doc/html/index.html
@@ -220,6 +220,9 @@ <h1>Perl-compatible Regular Expressions (revised API: PCRE2)</h1>
 <tr><td><a href="pcre2_match_data_free.html">pcre2_match_data_free</a></td>
     <td>Free a match data block</td></tr>
 
+<tr><td><a href="pcre2_next_match.html">pcre2_next_match</a></td>
+    <td>Get the match parameters for the next match</td></tr>
+
 <tr><td><a href="pcre2_pattern_convert.html">pcre2_pattern_convert</a></td>
     <td>Experimental foreign pattern converter</td></tr>
 

diff --git a/doc/html/pcre2_next_match.html b/doc/html/pcre2_next_match.html
@@ -0,0 +1,55 @@
+<html>
+<head>
+<title>pcre2_next_match specification</title>
+</head>
+<body bgcolor="#FFFFFF" text="#00005A" link="#0066FF" alink="#3399FF" vlink="#2222BB">
+<h1>pcre2_next_match man page</h1>
+<p>
+Return to the <a href="index.html">PCRE2 index page</a>.
+</p>
+<p>
+This page is part of the PCRE2 HTML documentation. It was generated
+automatically from the original man page. If there is any nonsense in it,
+please consult the man page, in case the conversion went wrong.
+<br>
+<h2>
+SYNOPSIS
+</h2>
+<p>
+<b>#include &#60;pcre2.h&#62;</b>
+</p>
+<p>
+<b>int pcre2_next_match(pcre2_match_data *<i>match_data</i>,</b>
+<b>  PCRE2_SIZE *<i>pstart_offset</i>, uint32_t *<i>poptions</i>);</b>
+</p>
+<h2>
+DESCRIPTION
+</h2>
+<p>
+This function can be called after one of the match functions
+(<b>pcre2_match()</b>, <b>pcre2_dfa_match()</b>, or <b>pcre2_jit_match()</b>), and
+must be provided with the same <i>match_data</i> parameter. It outputs the
+appropriate parameters for searching for the next match in the same subject
+string, and is suitable for applications providing "global" matching behaviour
+(for example, replacing all matches in the subject, or splitting the subject on
+all matches, or simply counting the number of matches).
+</p>
+<p>
+It returns 0 ("false") if there is no need to make any further match attempts,
+or 1 ("true") if another match should be attempted.
+</p>
+<p>
+The *<i>pstart_offset</i> and *<i>poptions</i> are set if the function returns 1.
+The *<i>pstart_offset</i> should be passed to the next match attempt directly,
+and the *<i>poptions</i> should be passed to the next match attempt by combining
+with the application's match options using OR.
+</p>
+<p>
+There is a complete description of the PCRE2 native API in the
+<a href="pcre2api.html"><b>pcre2api</b></a>
+page and a description of the POSIX API in the
+<a href="pcre2posix.html"><b>pcre2posix</b></a>
+page.
+<p>
+Return to the <a href="index.html">PCRE2 index page</a>.
+</p>