From 48f0bac7fd58fb65e7a74293551a80db722a4dce Mon Sep 17 00:00:00 2001
From: Kamil Tekiela <tekiela246@gmail.com>
Date: Fri, 6 Aug 2021 13:59:30 +0100
Subject: [PATCH] Updating mysqli: bind_result (#770)

---
 reference/mysqli/mysqli_stmt/bind-result.xml | 87 ++++++++------------
 1 file changed, 36 insertions(+), 51 deletions(-)

diff --git a/reference/mysqli/mysqli_stmt/bind-result.xml b/reference/mysqli/mysqli_stmt/bind-result.xml
index b741beefad..bde4d1150c 100644
--- a/reference/mysqli/mysqli_stmt/bind-result.xml
+++ b/reference/mysqli/mysqli_stmt/bind-result.xml
@@ -30,20 +30,31 @@
    MySQL client/server protocol places the data for the bound columns into
    the specified variables <parameter>var</parameter>/<parameter>vars</parameter>.
   </para>
+  <para>
+   A column can be bound or rebound at any time, even after a result set has
+   been partially retrieved. The new binding takes effect the next time 
+   <function>mysqli_stmt_fetch</function> is called.
+  </para>
   <note>
    <para>
-    Note that all columns must be bound after 
+    All columns must be bound after 
     <function>mysqli_stmt_execute</function> and prior to calling
     <function>mysqli_stmt_fetch</function>.
+   </para>
+  </note>
+  <note>
+   <para>
     Depending on column types bound variables can silently change to the
     corresponding PHP type.
    </para>
-   <para>
-    A column can be bound or rebound at any time, even after a result set has
-    been partially retrieved. The new binding takes effect the next time 
-    <function>mysqli_stmt_fetch</function> is called.
-   </para>
   </note>
+  <tip>
+   <para>
+    This functions is useful for simple results. To retrieve iterable result
+    set, or fetch each row as an array or object,
+    use <function>mysqli_stmt_get_result</function>.
+   </para>
+  </tip>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -85,32 +96,21 @@
    <programlisting role="php">
 <![CDATA[
 <?php
+
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
 $mysqli = new mysqli("localhost", "my_user", "my_password", "world");
 
-if (mysqli_connect_errno()) {
-    printf("Connect failed: %s\n", mysqli_connect_error());
-    exit();
-}
-
 /* prepare statement */
-if ($stmt = $mysqli->prepare("SELECT Code, Name FROM Country ORDER BY Name LIMIT 5")) {
-    $stmt->execute();
+$stmt = $mysqli->prepare("SELECT Code, Name FROM Country ORDER BY Name LIMIT 5");
+$stmt->execute();
 
-    /* bind variables to prepared statement */
-    $stmt->bind_result($col1, $col2);
+/* bind variables to prepared statement */
+$stmt->bind_result($col1, $col2);
 
-    /* fetch values */
-    while ($stmt->fetch()) {
-        printf("%s %s\n", $col1, $col2);
-    }
-
-    /* close statement */
-    $stmt->close();
+/* fetch values */
+while ($stmt->fetch()) {
+    printf("%s %s\n", $col1, $col2);
 }
-/* close connection */
-$mysqli->close();
-
-?>
 ]]>
    </programlisting>
   </example>
@@ -119,36 +119,24 @@ $mysqli->close();
    <programlisting role="php">
 <![CDATA[
 <?php
+
+mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
 $link = mysqli_connect("localhost", "my_user", "my_password", "world");
 
-/* check connection */
-if (!$link) {
-    printf("Connect failed: %s\n", mysqli_connect_error());
-    exit();
-}
-
 /* prepare statement */
-if ($stmt = mysqli_prepare($link, "SELECT Code, Name FROM Country ORDER BY Name LIMIT 5")) {
-    mysqli_stmt_execute($stmt);
+$stmt = mysqli_prepare($link, "SELECT Code, Name FROM Country ORDER BY Name LIMIT 5");
+mysqli_stmt_execute($stmt);
 
-    /* bind variables to prepared statement */
-    mysqli_stmt_bind_result($stmt, $col1, $col2);
+/* bind variables to prepared statement */
+mysqli_stmt_bind_result($stmt, $col1, $col2);
 
-    /* fetch values */
-    while (mysqli_stmt_fetch($stmt)) {
-        printf("%s %s\n", $col1, $col2);
-    }
-
-    /* close statement */
-    mysqli_stmt_close($stmt);
+/* fetch values */
+while (mysqli_stmt_fetch($stmt)) {
+    printf("%s %s\n", $col1, $col2);
 }
-
-/* close connection */
-mysqli_close($link);
-?>
 ]]>
    </programlisting>
-   &examples.outputs;
+   &examples.outputs.similar;
    <screen>
 <![CDATA[
 AFG Afghanistan
@@ -171,9 +159,6 @@ AND Andorra
     <member><function>mysqli_stmt_fetch</function></member>
     <member><function>mysqli_prepare</function></member>
     <member><function>mysqli_stmt_prepare</function></member>
-    <member><function>mysqli_stmt_init</function></member>
-    <member><function>mysqli_stmt_errno</function></member>
-    <member><function>mysqli_stmt_error</function></member>
    </simplelist>
   </para>
  </refsect1>