Regex

gto76 · gto76 · commit 528cee42011f · 2026-01-09T13:02:53.000+01:00
diff --git a/README.md b/README.md
@@ -361,35 +361,35 @@ Regex
 
 ```python
 import re
-<str>   = re.sub(r'<regex>', new, text, count=0)  # Substitutes occurrences with string 'new'.
-<list>  = re.findall(r'<regex>', text)            # Returns all occurrences as string objects.
-<list>  = re.split(r'<regex>', text, maxsplit=0)  # Add brackets around regex to keep matches.
-<Match> = re.search(r'<regex>', text)             # Returns first occ. of the pattern or None.
-<Match> = re.match(r'<regex>', text)              # Only searches at the start of the 'text'.
-<iter>  = re.finditer(r'<regex>', text)           # Returns all occurrences as Match objects.
+<str>   = re.sub(r'<regex>', new, text)  # Substitutes occurrences with string 'new'.
+<list>  = re.findall(r'<regex>', text)   # Returns all occurrences as string objects.
+<list>  = re.split(r'<regex>', text)     # Add brackets around regex to keep matches.
+<Match> = re.search(r'<regex>', text)    # Returns first occ. of the pattern or None.
+<Match> = re.match(r'<regex>', text)     # Only searches at the start of the 'text'.
+<iter>  = re.finditer(r'<regex>', text)  # Returns all occurrences as Match objects.
 ```
 
 * **Raw string literals do not interpret escape sequences, thus enabling us to use the regex-specific escape sequences that cause SyntaxWarning in normal string literals (since 3.12).**
-* **Argument 'new' of re.sub() can be a function that accepts Match obj. and returns a string.**
+* **Argument `'new'` can also be a function that accepts a Match object and returns a string.**
 * **Argument `'flags=re.IGNORECASE'` can be used with all functions that are listed above.**
 * **Argument `'flags=re.MULTILINE'` makes `'^'` and `'$'` match the start/end of each line.**
 * **Argument `'flags=re.DOTALL'` makes `'.'` also accept the `'\n'` (besides all other chars).**
 * **`'re.compile(r"<regex>")'` returns a Pattern object with methods sub(), findall(), etc.**
 
 ### Match Object
 ```python
-<str>   = <Match>.group()                         # Returns the whole match. Also group(0).
-<str>   = <Match>.group(1)                        # Returns part inside the first brackets.
-<tuple> = <Match>.groups()                        # Returns all bracketed parts as strings.
-<int>   = <Match>.start()                         # Returns start index of the whole match.
-<int>   = <Match>.end()                           # Returns the match's end index plus one.
+<str>   = <Match>.group()                # Returns the whole match. Also group(0).
+<str>   = <Match>.group(1)               # Returns part inside the first brackets.
+<tuple> = <Match>.groups()               # Returns all bracketed parts as strings.
+<int>   = <Match>.start()                # Returns start index of the whole match.
+<int>   = <Match>.end()                  # Returns the match's end index plus one.
 ```
 
 ### Special Sequences
 ```python
-'\d' == '[0-9]'                                   # Also [०-९…]. Matches decimal character.
-'\w' == '[a-zA-Z0-9_]'                            # Also [ª²³…]. Matches alphanumeric or _.
-'\s' == '[ \t\n\r\f\v]'                           # Also [\x1c-\x1f…]. Matches whitespace.
+'\d' == '[0-9]'                          # Also [०-९…]. Matches decimal character.
+'\w' == '[a-zA-Z0-9_]'                   # Also [ª²³…]. Matches alphanumeric or _.
+'\s' == '[ \t\n\r\f\v]'                  # Also [\x1c-\x1f…]. Matches whitespace.
 ```
 * **By default, decimal characters and alphanumerics from all alphabets are matched unless `'flags=re.ASCII'` is used. It restricts special sequence matches to the first 128 Unicode characters and also prevents `'\s'` from accepting `'\x1c'`, `'\x1d'`, `'\x1e'` and `'\x1f'` (non-printable characters that divide text into files, tables, rows and fields, respectively).**
 * **Use a capital letter, i.e. `'\D'`, `'\W'` or `'\S'`, for negation. All non-ASCII characters are matched if ASCII flag is used in conjunction with a capital letter.**
diff --git a/index.html b/index.html
@@ -56,7 +56,7 @@
 
 <body>
   <header>
-    <aside>January 8, 2026</aside>
+    <aside>January 9, 2026</aside>
     <a href="https://gto76.github.io" rel="author">Jure Šorn</a>
   </header>
 
@@ -343,33 +343,33 @@
 &lt;bool&gt; = &lt;str&gt;.isspace()                     <span class="hljs-comment"># Checks for [ \t\n\r\f\v\x1c\x1d\x1e\x1f\x85…].</span>
 </code></pre>
 <div><h2 id="regex"><a href="#regex" name="regex">#</a>Regex</h2><p><strong>Functions for regular expression matching.</strong></p><pre><code class="python language-python hljs"><span class="hljs-keyword">import</span> re
-&lt;str&gt;   = re.sub(<span class="hljs-string">r'&lt;regex&gt;'</span>, new, text, count=<span class="hljs-number">0</span>)  <span class="hljs-comment"># Substitutes occurrences with string 'new'.</span>
-&lt;list&gt;  = re.findall(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)            <span class="hljs-comment"># Returns all occurrences as string objects.</span>
-&lt;list&gt;  = re.split(<span class="hljs-string">r'&lt;regex&gt;'</span>, text, maxsplit=<span class="hljs-number">0</span>)  <span class="hljs-comment"># Add brackets around regex to keep matches.</span>
-&lt;Match&gt; = re.search(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)             <span class="hljs-comment"># Returns first occ. of the pattern or None.</span>
-&lt;Match&gt; = re.match(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)              <span class="hljs-comment"># Only searches at the start of the 'text'.</span>
-&lt;iter&gt;  = re.finditer(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)           <span class="hljs-comment"># Returns all occurrences as Match objects.</span>
+&lt;str&gt;   = re.sub(<span class="hljs-string">r'&lt;regex&gt;'</span>, new, text)  <span class="hljs-comment"># Substitutes occurrences with string 'new'.</span>
+&lt;list&gt;  = re.findall(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)   <span class="hljs-comment"># Returns all occurrences as string objects.</span>
+&lt;list&gt;  = re.split(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)     <span class="hljs-comment"># Add brackets around regex to keep matches.</span>
+&lt;Match&gt; = re.search(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)    <span class="hljs-comment"># Returns first occ. of the pattern or None.</span>
+&lt;Match&gt; = re.match(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)     <span class="hljs-comment"># Only searches at the start of the 'text'.</span>
+&lt;iter&gt;  = re.finditer(<span class="hljs-string">r'&lt;regex&gt;'</span>, text)  <span class="hljs-comment"># Returns all occurrences as Match objects.</span>
 </code></pre></div>
 
 
 <ul>
 <li><strong>Raw string literals do not interpret escape sequences, thus enabling us to use the regex-specific escape sequences that cause SyntaxWarning in normal string literals (since 3.12).</strong></li>
-<li><strong>Argument 'new' of re.sub() can be a function that accepts Match obj. and returns a string.</strong></li>
+<li><strong>Argument <code class="python hljs"><span class="hljs-string">'new'</span></code> can also be a function that accepts a Match object and returns a string.</strong></li>
 <li><strong>Argument <code class="python hljs"><span class="hljs-string">'flags=re.IGNORECASE'</span></code> can be used with all functions that are listed above.</strong></li>
 <li><strong>Argument <code class="python hljs"><span class="hljs-string">'flags=re.MULTILINE'</span></code> makes <code class="python hljs"><span class="hljs-string">'^'</span></code> and <code class="python hljs"><span class="hljs-string">'$'</span></code> match the start/end of each line.</strong></li>
 <li><strong>Argument <code class="python hljs"><span class="hljs-string">'flags=re.DOTALL'</span></code> makes <code class="python hljs"><span class="hljs-string">'.'</span></code> also accept the <code class="python hljs"><span class="hljs-string">'\n'</span></code> (besides all other chars).</strong></li>
 <li><strong><code class="python hljs"><span class="hljs-string">'re.compile(r"&lt;regex&gt;")'</span></code> returns a Pattern object with methods sub(), findall(), etc.</strong></li>
 </ul>
-<div><h3 id="matchobject">Match Object</h3><pre><code class="python language-python hljs">&lt;str&gt;   = &lt;Match&gt;.group()                         <span class="hljs-comment"># Returns the whole match. Also group(0).</span>
-&lt;str&gt;   = &lt;Match&gt;.group(<span class="hljs-number">1</span>)                        <span class="hljs-comment"># Returns part inside the first brackets.</span>
-&lt;tuple&gt; = &lt;Match&gt;.groups()                        <span class="hljs-comment"># Returns all bracketed parts as strings.</span>
-&lt;int&gt;   = &lt;Match&gt;.start()                         <span class="hljs-comment"># Returns start index of the whole match.</span>
-&lt;int&gt;   = &lt;Match&gt;.end()                           <span class="hljs-comment"># Returns the match's end index plus one.</span>
+<div><h3 id="matchobject">Match Object</h3><pre><code class="python language-python hljs">&lt;str&gt;   = &lt;Match&gt;.group()                <span class="hljs-comment"># Returns the whole match. Also group(0).</span>
+&lt;str&gt;   = &lt;Match&gt;.group(<span class="hljs-number">1</span>)               <span class="hljs-comment"># Returns part inside the first brackets.</span>
+&lt;tuple&gt; = &lt;Match&gt;.groups()               <span class="hljs-comment"># Returns all bracketed parts as strings.</span>
+&lt;int&gt;   = &lt;Match&gt;.start()                <span class="hljs-comment"># Returns start index of the whole match.</span>
+&lt;int&gt;   = &lt;Match&gt;.end()                  <span class="hljs-comment"># Returns the match's end index plus one.</span>
 </code></pre></div>
 
-<div><h3 id="specialsequences">Special Sequences</h3><pre><code class="python language-python hljs"><span class="hljs-string">'\d'</span> == <span class="hljs-string">'[0-9]'</span>                                   <span class="hljs-comment"># Also [०-९…]. Matches decimal character.</span>
-<span class="hljs-string">'\w'</span> == <span class="hljs-string">'[a-zA-Z0-9_]'</span>                            <span class="hljs-comment"># Also [ª²³…]. Matches alphanumeric or _.</span>
-<span class="hljs-string">'\s'</span> == <span class="hljs-string">'[ \t\n\r\f\v]'</span>                           <span class="hljs-comment"># Also [\x1c-\x1f…]. Matches whitespace.</span>
+<div><h3 id="specialsequences">Special Sequences</h3><pre><code class="python language-python hljs"><span class="hljs-string">'\d'</span> == <span class="hljs-string">'[0-9]'</span>                          <span class="hljs-comment"># Also [०-९…]. Matches decimal character.</span>
+<span class="hljs-string">'\w'</span> == <span class="hljs-string">'[a-zA-Z0-9_]'</span>                   <span class="hljs-comment"># Also [ª²³…]. Matches alphanumeric or _.</span>
+<span class="hljs-string">'\s'</span> == <span class="hljs-string">'[ \t\n\r\f\v]'</span>                  <span class="hljs-comment"># Also [\x1c-\x1f…]. Matches whitespace.</span>
 </code></pre></div>
 
 <ul>
@@ -2933,7 +2933,7 @@ <h3 id="format-2">Format</h3><div><h4 id="forstandardtypesizesandmanualalignment
  
 
   <footer>
-    <aside>January 8, 2026</aside>
+    <aside>January 9, 2026</aside>
     <a href="https://gto76.github.io" rel="author">Jure Šorn</a>
   </footer>
 
