PDOStatement::bindParam maxLength is confusing

php/doc-en@3562cc1

Author: mumumu

reference/pdo/pdostatement/bindparam.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 65d4ecb42e75a180eb8964968c230b09d81d3601 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 3562cc154f5f0dbc22918706708fcd745ed7771a Maintainer: takagi Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="pdostatement.bindparam" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -69,7 +69,8 @@
         <link linkend="pdo.constants"><literal>PDO::PARAM_*</literal> 定数</link>
         を使った明示的なデータ型を指定します。
         ストアドプロシージャからの INOUT パラメータの場合、
-        <parameter>type</parameter> パラメータに PDO::PARAM_INPUT_OUTPUT
+        <parameter>type</parameter> パラメータに
+        <constant>PDO::PARAM_INPUT_OUTPUT</constant>
         ビットを設定するためにビット OR を使用してください。
        </para>
       </listitem>
@@ -81,6 +82,9 @@
         データ型の長さを指定します。パラメータがストアドプロシージャからの
         OUT パラメータであることを示す場合、
         明示的に長さを設定しなければなりません。
+        この値は、<parameter>type</parameter> パラメータに
+        <constant>PDO::PARAM_INPUT_OUTPUT</constant>
+        を指定した場合のみ意味があります。
        </para>
       </listitem>
      </varlistentry>
@@ -117,7 +121,7 @@ $sth = $dbh->prepare('SELECT name, colour, calories
     WHERE calories < :calories AND colour = :colour');
 $sth->bindParam('calories', $calories, PDO::PARAM_INT);
 /* 名前の前にも、コロン ":" を付けることができます(オプション) */
-$sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12);
+$sth->bindParam(':colour', $colour, PDO::PARAM_STR);
 $sth->execute();
 ?>
 ]]>
@@ -135,7 +139,7 @@ $sth = $dbh->prepare('SELECT name, colour, calories
     FROM fruit
     WHERE calories < ? AND colour = ?');
 $sth->bindParam(1, $calories, PDO::PARAM_INT);
-$sth->bindParam(2, $colour, PDO::PARAM_STR, 12);
+$sth->bindParam(2, $colour, PDO::PARAM_STR);
 $sth->execute();
 ?>
 ]]>