svn: /phpdoc/en/trunk/reference/sqlite3/sqlite3/ querysingle.xml
| From: | Adam Harvey | Date: | Wed, 13 Oct 2010 09:08:43 +0000 |
| Subject: | svn: /phpdoc/en/trunk/reference/sqlite3/sqlite3/ querysingle.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-7213@lists.php.net to get a copy of this message | ||
aharvey Wed, 13 Oct 2010 09:08:43 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=304366
Log:
Fix doc bug #52997 (SQLite3::querySingle omits return type information).
Bug: http://bugs.php.net/52997 (Open) SQLite3::querySingle
omits return type information
Changed paths:
U phpdoc/en/trunk/reference/sqlite3/sqlite3/querysingle.xml
Modified: phpdoc/en/trunk/reference/sqlite3/sqlite3/querysingle.xml
===================================================================
--- phpdoc/en/trunk/reference/sqlite3/sqlite3/querysingle.xml 2010-10-13 08:58:01 UTC (rev 304365)
+++ phpdoc/en/trunk/reference/sqlite3/sqlite3/querysingle.xml 2010-10-13 09:08:43 UTC (rev 304366)
@@ -35,9 +35,10 @@
<term><parameter>entire_row</parameter></term>
<listitem>
<para>
- By default, querySingle returns the value of the first column returned
- by the query. If entire_row is &true;, then it returns an array of the
- entire first row.
+ By default, <function>querySingle</function> returns the value of the
+ first column returned by the query. If
+ <parameter>entire_row</parameter> is &true;, then it returns an array
+ of the entire first row.
</para>
</listitem>
</varlistentry>
@@ -50,8 +51,16 @@
&reftitle.returnvalues;
<para>
Returns the value of the first column of results or an array of the entire
- first row (if entire_row is &true;), otherwise &false; on failure.
+ first row (if <parameter>entire_row</parameter> is &true;).
</para>
+ <para>
+ If the query is valid but no results are returned, then &null; will be
+ returned if <parameter>entire_row</parameter> is &false;, otherwise an
+ empty array is returned.
+ </para>
+ <para>
+ Invalid or failing queries will return &false;.
+ </para>
</refsect1>
<refsect1 role="examples">