From b399f2cf51e3769e75c72a928386505feba43419 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud Catoire <la.catoire@gmail.com>
Date: Fri, 6 Feb 2026 19:12:45 +0100
Subject: [PATCH] Document intval() behavior with scientific notation strings

---
 reference/var/functions/intval.xml | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/reference/var/functions/intval.xml b/reference/var/functions/intval.xml
index af7416bd6e..fa42149e93 100644
--- a/reference/var/functions/intval.xml
+++ b/reference/var/functions/intval.xml
@@ -101,6 +101,29 @@
    <link linkend="language.types.integer.casting">transtypage d'entier</link> 
    s'applique.
   </para>
+  <note>
+   <para>
+    Les chaînes numériques utilisant la notation scientifique (par exemple
+    contenant la lettre <literal>e</literal>) sont d'abord interprétées comme
+    des nombres avant d'être converties en entier.
+   </para>
+   <para>
+    Cela peut conduire à des résultats inattendus pour de grands exposants :
+   </para>
+   <example>
+    <title>Exemple</title>
+    <programlisting role="php">
+<![CDATA[
+echo intval('42.42e42'); // 9223372036854775807 sur les systèmes 64 bits
+]]>
+    </programlisting>
+   </example>
+   <para>
+    Voir <link linkend="language.types.numeric-strings">Chaînes numériques</link>
+    pour plus de détails sur l'interprétation de ce type de chaînes.
+   </para>
+  </note>
+
  </refsect1>
  <refsect1 role="changelog">
   &reftitle.changelog;