[doc-en] master: ext/mbstring: mb_*code_numericentity Clarify the ValueError conditions (#4852)
| From: | Mikhail Alferov via GitHub | Date: | Tue, 01 Sep 2026 19:49:51 +0000 |
| Subject: | [doc-en] master: ext/mbstring: mb_*code_numericentity Clarify the ValueError conditions (#4852) | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-23692@lists.php.net to get a copy of this message | ||
Author: Mikhail Alferov (mmalferov)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-09-01T21:49:48+02:00
Commit: https://github.com/php/doc-en/commit/3505aae96c190f3970e15bf3b7a12ead73b95662
Raw diff: https://github.com/php/doc-en/commit/3505aae96c190f3970e15bf3b7a12ead73b95662.diff
ext/mbstring: mb_*code_numericentity Clarify the ValueError conditions (#4852)
* mb-decode-numericentity.xml Clarify the ValueError conditions
Co-authored-by: Louis-Arnaud <la.catoire@gmail.com>
Changed paths:
M reference/mbstring/functions/mb-decode-numericentity.xml
M reference/mbstring/functions/mb-encode-numericentity.xml
Diff:
diff --git a/reference/mbstring/functions/mb-decode-numericentity.xml
b/reference/mbstring/functions/mb-decode-numericentity.xml
index 151b8855cd85..af2002729281 100644
--- a/reference/mbstring/functions/mb-decode-numericentity.xml
+++ b/reference/mbstring/functions/mb-decode-numericentity.xml
@@ -62,7 +62,8 @@
&reftitle.errors;
<simpara>
Throws a <exceptionname>ValueError</exceptionname> if
- <parameter>map</parameter> is not a list of &integer;s.
+ <parameter>map</parameter> contains any value that is not an
+ &integer;, &float;, &boolean;, &null;, or a <link
linkend="language.types.numeric-strings">numeric string</link>.
</simpara>
</refsect1>
@@ -80,9 +81,9 @@
<row>
<entry>8.4.0</entry>
<entry>
- <function>mb_decode_numericentity</function> now throws a
+ The <function>mb_decode_numericentity</function> function now throws a
<exceptionname>ValueError</exceptionname> if
<parameter>map</parameter>
- is not a list of &integer;s.
+ contains any value that cannot be implicitly converted to int.
</entry>
</row>
&mbstring.changelog.encoding-nullable;
diff --git a/reference/mbstring/functions/mb-encode-numericentity.xml
b/reference/mbstring/functions/mb-encode-numericentity.xml
index 7334bdeed352..4aa19143400f 100644
--- a/reference/mbstring/functions/mb-encode-numericentity.xml
+++ b/reference/mbstring/functions/mb-encode-numericentity.xml
@@ -73,7 +73,8 @@
&reftitle.errors;
<simpara>
Throws a <exceptionname>ValueError</exceptionname> if
- <parameter>map</parameter> is not a list of &integer;s.
+ <parameter>map</parameter> contains any value that is not an
+ &integer;, &float;, &boolean;, &null;, or a <link
linkend="language.types.numeric-strings">numeric string</link>.
</simpara>
</refsect1>
@@ -91,9 +92,9 @@
<row>
<entry>8.4.0</entry>
<entry>
- <function>mb_encode_numericentity</function> now throws a
+ The <function>mb_encode_numericentity</function> function now throws a
<exceptionname>ValueError</exceptionname> if
<parameter>map</parameter>
- is not a list of &integer;s.
+ contains any value that cannot be implicitly converted to int.
</entry>
</row>
&mbstring.changelog.encoding-nullable;