php-doc-en/reference/sqlite/functions/sqlite-key.xml
Adam Harvey c9f928c690 Change the documentation of sqlite_key() to reflect that it can only be called
as an instance method, unlike every other SQLite function. The previous
changelog was, in fact, completely incorrect.

This is absolutely not the right way to do this, and anyone who has a better
idea for how to represent this case is welcome to commit their own fix.
Unfortunately, because the OO API is just a set of method aliases for the
procedural API and it's infrequently used, we don't have the class/method
structure that we have in (say) mysqli, and attempting to retrofit it now would
result in all of the URLs for the SQLite function pages breaking.

Ugh.

Fixes doc bug #54073 (The sqlite_key() documentation should mentioned
procedural usage), for a very low value of fixes.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328319 c90b9560-bf6c-de11-be94-00142212c4b1
2012-11-12 09:25:24 +00:00

66 lines
1.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="function.sqlite-key" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>sqlite_key</refname>
<refname>SQLiteResult::key</refname>
<refpurpose>Returns the current row index</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>&style.oop; (method):</para>
<methodsynopsis>
<type>int</type><methodname>SQLiteResult::key</methodname>
<void/>
</methodsynopsis>
<para>
<methodname>SQLiteResult::key</methodname> returns the current row index of
the buffered result set <parameter>result</parameter>.
</para>
<para>
Unlike all other SQLite functions, this function does not have a procedural
version, and can only be called as a method on a
<classname>SQLiteResult</classname> object.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the current row index of the buffered result set
<parameter>result</parameter>.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>sqlite_next</function></member>
<member><function>sqlite_current</function></member>
<member><function>sqlite_rewind</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->