svn commit - mysqldoc@docsrva: r1871 - in trunk: . refman-5.0 refman-5.1

[paul]

Author: paul
Date: 2006-04-19 19:25:05 +0200 (Wed, 19 Apr 2006)
New Revision: 1871

Log:
 r6769@polar:  paul | 2006-04-19 12:22:15 -0500
 Clarify interpretation of *MYSQL_BIND.length when mysql_stmt_fetch()
 returns MYSQL_DATA_TRUNCATED. (Bug#16289)


Modified:
   trunk/
   trunk/refman-5.0/apis.xml
   trunk/refman-5.1/apis.xml


Property changes on: trunk
___________________________________________________________________
Name: svk:merge
   - 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:6745
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:9568
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:4545
   + 4767c598-dc10-0410-bea0-d01b485662eb:/mysqldoc-local/mysqldoc/trunk:6769
b5ec3a16-e900-0410-9ad2-d183a3acac99:/mysqldoc-local/mysqldoc/trunk:9568
bf112a9c-6c03-0410-a055-ad865cd57414:/mysqldoc-local/mysqldoc/trunk:4545

Modified: trunk/refman-5.0/apis.xml
===================================================================
--- trunk/refman-5.0/apis.xml	2006-04-19 17:13:36 UTC (rev 1870)
+++ trunk/refman-5.0/apis.xml	2006-04-19 17:25:05 UTC (rev 1871)
@@ -8332,10 +8332,19 @@
                 long</literal> variable that indicates the length of the
                 parameter value stored in <literal>*buffer</literal>;
                 this is used by <literal>mysql_stmt_execute()</literal>.
-                For output value binding,
-                <literal>mysql_stmt_fetch()</literal> places the length
-                of the column value that is returned into the variable
-                that <literal>length</literal> points to.
+                For output value binding, the return value of
+                <literal>mysql_stmt_fetch()</literal> determines the
+                interpretation of the length. If
+                <literal>mysql_stmt_fetch()</literal> returns 0,
+                <literal>*length</literal> indicates the actual length
+                of the parameter value. If
+                <literal>mysql_stmt_fetch()</literal> returns
+                <literal>MYSQL_DATA_TRUNCATED</literal>,
+                <literal>*length</literal> indicates the non-truncated
+                length of the parameter value. In this case, the minimum
+                of <literal>*length</literal> and
+                <literal>buffer_length</literal> indicates the actual
+                length of the value.
               </para>
 
               <para>

Modified: trunk/refman-5.1/apis.xml
===================================================================
--- trunk/refman-5.1/apis.xml	2006-04-19 17:13:36 UTC (rev 1870)
+++ trunk/refman-5.1/apis.xml	2006-04-19 17:25:05 UTC (rev 1871)
@@ -8201,10 +8201,19 @@
                 long</literal> variable that indicates the length of the
                 parameter value stored in <literal>*buffer</literal>;
                 this is used by <literal>mysql_stmt_execute()</literal>.
-                For output value binding,
-                <literal>mysql_stmt_fetch()</literal> places the length
-                of the column value that is returned into the variable
-                that <literal>length</literal> points to.
+                For output value binding, the return value of
+                <literal>mysql_stmt_fetch()</literal> determines the
+                interpretation of the length. If
+                <literal>mysql_stmt_fetch()</literal> returns 0,
+                <literal>*length</literal> indicates the actual length
+                of the parameter value. If
+                <literal>mysql_stmt_fetch()</literal> returns
+                <literal>MYSQL_DATA_TRUNCATED</literal>,
+                <literal>*length</literal> indicates the non-truncated
+                length of the parameter value. In this case, the minimum
+                of <literal>*length</literal> and
+                <literal>buffer_length</literal> indicates the actual
+                length of the value.
               </para>
 
               <para>