php-doc-en/reference/msql/functions/msql-result.xml
Kenneth Schwartz 2f04793f55 msql docs update
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@152764 c90b9560-bf6c-de11-be94-00142212c4b1
2004-03-02 10:16:07 +00:00

72 lines
2.6 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/msql.xml, last change in rev 1.2 -->
<refentry id="function.msql-result">
<refnamediv>
<refname>msql_result</refname>
<refpurpose>Get result data</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>msql_result</methodname>
<methodparam><type>resource</type><parameter>query_identifier</parameter></methodparam>
<methodparam><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>field</parameter></methodparam>
</methodsynopsis>
<para>
Returns the contents of the cell at the row and offset in the
specified mSQL result set.
</para>
<para>
<function>msql_result</function> returns the contents of one cell
from a mSQL result set. The field argument can be the field's
offset, or the field's name, or the field's table dot field's
name (fieldname.tablename). If the column name has been aliased
('select foo as bar from ...'), use the alias instead of the
column name.
</para>
<para>
When working on large result sets, you should consider using one
of the functions that fetch an entire row (specified below). As
these functions return the contents of multiple cells in one
function call, they are often much quicker than
<function>msql_result</function>. Also, note that specifying a
numeric offset for the field argument is much quicker than
specifying a fieldname or tablename.fieldname argument.
</para>
<para>
Recommended high-performance alternatives:
<function>msql_fetch_row</function>,
<function>msql_fetch_array</function>, and
<function>msql_fetch_object</function>.
</para>
<para>
For downward compatibility, the aliases named
<function>msql</function>, <function>msql_tablename</function>, and
<function>msql_dbname</function> may be used. This, however, is
deprecated and not recommended.
</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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../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
-->