ludic/regex-next.html
2026-09-17 22:10:03 +00:00

37 lines
No EOL
2.3 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Regex.next — Ludic</title>
<meta name="description" content="The next match at or after byte offset from — the basis of a find-all loop.">
<link rel="stylesheet" href="base.css">
<link rel="stylesheet" href="docs.css">
</head>
<body>
<header class="nav"><div class="wrap nav-in"><a class="brand" href="index.html"><span class="logo">L</span> Ludic</a><button class="nav-toggle" aria-label="Toggle menu" aria-expanded="false">☰</button><nav class="nav-links"><a href="index.html">Home</a><a href="api.html">API Reference</a><a class="nav-cta" href="https://git.workshopsoft.io/workshopsoft/ludic">Source ↗</a></nav></div></header>
<main class="wrap item">
<div class="crumbs"><a href="api.html">API Reference</a> <span>›</span> <a href="ns-regex.html">Regex</a> <span>›</span> <span class="here">Regex.next</span></div>
<div class="item-head">
<span class="kind-badge kind-method">method</span>
<h1 id="top">Regex.next</h1>
</div>
<code class="sig">Regex.next(text, re, from) -&gt; Match</code>
<div class="desc"><p>Returns the first match of <code>re</code> in <code>text</code> starting at or after byte offset <code>from</code>, or <code>null</code>. Loop it from the previous match's end (see <a href="regex-end"><code>Regex.end</code></a>) to iterate every match — the find-all idiom.</p></div>
<div class="params"><h2>Parameters</h2><div class="param" id="param-text"><code class="pname">text</code><span class="pdesc">the string to search</span></div><div class="param" id="param-re"><code class="pname">re</code><span class="pdesc">a compiled <code>Regex</code></span></div><div class="param" id="param-from"><code class="pname">from</code><span class="pdesc">the byte offset to resume from</span></div></div>
<div class="examples"><h2>Example</h2><pre data-lang="ludic">program Demo {
entry {
let re = Regex.compile("#(\\w+)")
var m = Regex.exec("#a #b #c", re)
while Regex.ok(m) {
print(Regex.group(m, 1))
m = Regex.next("#a #b #c", re, Regex.end(m, 0))
}
}
}</pre></div>
<a class="back" href="api.html">← All symbols</a>
</main>
<script src="ludic-highlight.js"></script>
<script>Ludic.highlightAll(); Ludic.installCards(); Ludic.flashTarget();</script>
</body></html>