From 5da461c02a5953e28d3ddacb631f220b188f95e0 Mon Sep 17 00:00:00 2001
From: Adam Harvey <aharvey@php.net>
Date: Wed, 4 Feb 2015 02:34:10 +0000
Subject: [PATCH] Update PDOStatement::fetchColumn() docs for the boolean
 column issue.

Fixes doc bug #68783 (pgsql: PDO::fetchColumn() false returned for value false
and no rows returned).


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@335883 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/pdo/pdostatement/fetchcolumn.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/reference/pdo/pdostatement/fetchcolumn.xml b/reference/pdo/pdostatement/fetchcolumn.xml
index 0ab8ac2895..60fabe32e2 100644
--- a/reference/pdo/pdostatement/fetchcolumn.xml
+++ b/reference/pdo/pdostatement/fetchcolumn.xml
@@ -11,7 +11,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <modifier>public</modifier> <type>string</type><methodname>PDOStatement::fetchColumn</methodname>
+   <modifier>public</modifier> <type>mixed</type><methodname>PDOStatement::fetchColumn</methodname>
    <methodparam choice="opt"><type>int</type><parameter>column_number</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
 
@@ -19,6 +19,15 @@
    Returns a single column from the next row of a result set or &false; if
    there are no more rows.
   </para>
+
+  <note>
+   <para>
+    <function>PDOStatement::fetchColumn</function> should not be used to
+    retrieve boolean columns, as it is impossible to distinguish a value of
+    &false; from there being no more rows to retrieve. Use
+    <function>PDOStatement::fetch</function> instead.
+   </para>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">