[DOC-CVS] [doc-en] master: ext/odbc: document the row default value change to null in fetch_object/array/into (PHP 8.4) (#5768)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-08-17T19:05:31+02:00

Commit: https://github.com/php/doc-en/commit/5035039fb951eac2330431bf47dc4a50e1ef9ee9
Raw diff: https://github.com/php/doc-en/commit/5035039fb951eac2330431bf47dc4a50e1ef9ee9.diff

ext/odbc: document the row default value change to null in fetch_object/array/into (PHP 8.4) (#5768)

* ext/odbc: Document row default value change to null in fetch_object/array/into (8.4.0)

* ext/odbc: Align the row parameter descriptions with the new default

* ext/odbc: Use simpara for the row parameter descriptions

Changed paths:
  M  reference/uodbc/functions/odbc-fetch-array.xml
  M  reference/uodbc/functions/odbc-fetch-into.xml
  M  reference/uodbc/functions/odbc-fetch-object.xml


Diff:

diff --git a/reference/uodbc/functions/odbc-fetch-array.xml b/reference/uodbc/functions/odbc-fetch-array.xml
index 400cc371b3a5..512e95b30280 100644
--- a/reference/uodbc/functions/odbc-fetch-array.xml
+++ b/reference/uodbc/functions/odbc-fetch-array.xml
@@ -33,9 +33,12 @@
     <varlistentry>
      <term><parameter>row</parameter></term>
      <listitem>
-      <para>
-       Optionally choose which row number to retrieve.
-      </para>
+      <simpara>
+       The 1-based number of the row to retrieve. If omitted or &null;, the
+       next row of the result set is fetched, as
+       <function>odbc_fetch_row</function> does. If the driver does not
+       support fetching rows by number, this parameter is ignored.
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -65,7 +68,9 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       <parameter>row</parameter> is now nullable.
+       <parameter>row</parameter> is now nullable, and its default value
+       changed from <literal>-1</literal> to &null;, consistent with
+       <function>odbc_fetch_row</function>.
       </entry>
      </row>
     </tbody>
diff --git a/reference/uodbc/functions/odbc-fetch-into.xml b/reference/uodbc/functions/odbc-fetch-into.xml
index 3642c9c89335..fb62debace8e 100644
--- a/reference/uodbc/functions/odbc-fetch-into.xml
+++ b/reference/uodbc/functions/odbc-fetch-into.xml
@@ -45,9 +45,12 @@
     <varlistentry>
      <term><parameter>row</parameter></term>
      <listitem>
-      <para>
-       The row number.
-      </para>
+      <simpara>
+       The 1-based number of the row to fetch. If omitted or &null;, the
+       next row of the result set is fetched, as
+       <function>odbc_fetch_row</function> does. If the driver does not
+       support fetching rows by number, this parameter is ignored.
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -77,7 +80,9 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       <parameter>row</parameter> is now nullable.
+       <parameter>row</parameter> is now nullable, and its default value
+       changed from <literal>0</literal> to &null;, consistent with
+       <function>odbc_fetch_row</function>.
       </entry>
      </row>
     </tbody>
diff --git a/reference/uodbc/functions/odbc-fetch-object.xml b/reference/uodbc/functions/odbc-fetch-object.xml
index 318446855c96..fb2814a83d8b 100644
--- a/reference/uodbc/functions/odbc-fetch-object.xml
+++ b/reference/uodbc/functions/odbc-fetch-object.xml
@@ -33,9 +33,12 @@
     <varlistentry>
      <term><parameter>row</parameter></term>
      <listitem>
-      <para>
-       Optionally choose which row number to retrieve.
-      </para>
+      <simpara>
+       The 1-based number of the row to retrieve. If omitted or &null;, the
+       next row of the result set is fetched, as
+       <function>odbc_fetch_row</function> does. If the driver does not
+       support fetching rows by number, this parameter is ignored.
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -65,7 +68,9 @@
      <row>
       <entry>8.4.0</entry>
       <entry>
-       <parameter>row</parameter> is now nullable.
+       <parameter>row</parameter> is now nullable, and its default value
+       changed from <literal>-1</literal> to &null;, consistent with
+       <function>odbc_fetch_row</function>.
       </entry>
      </row>
     </tbody>