php-doc-en/reference/maxdb/functions/maxdb-fetch-object.xml
Thomas Simenec c5ff12273c MaxDB PHP documentation
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@177090 c90b9560-bf6c-de11-be94-00142212c4b1
2005-01-12 18:53:25 +00:00

125 lines
3 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1.1.1 $ -->
<refentry id="function.maxdb-fetch-resource">
<refnamediv>
<refname>maxdb_fetch_resource</refname>
<refpurpose>Returns the current row of a result set as an resource</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>Procedural style:</para>
<methodsynopsis>
<type>mixed</type><methodname>maxdb_fetch_resource</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
The <function>maxdb_fetch_resource</function> will return the current row result set
as an resource where the attributes of the resource represent the names of the fields found
within the result set. If no more rows exist in the current result set, &null; is returned.
</para>
</refsect1>
<refsect1>
<title>Return values</title>
<para>
Returns an resource that corresponds to the fetched row or &null; if there are no more rows in resultset.
</para>
&database.field-case;
&database.fetch-null;
</refsect1>
<refsect1>
<title>See also</title>
<para>
<function>maxdb_fetch_array</function>,
<function>maxdb_fetch_assoc</function>,
<function>maxdb_fetch_row</function>.
</para>
</refsect1>
<refsect1>
<title>Example</title>
<example>
<title>Procedural style</title>
<programlisting role="php">
<![CDATA[
<?php
$link = maxdb_connect("localhost", "MONA", "RED");
/* check connection */
if (maxdb_connect_errno()) {
printf("Connect failed: %s\n", maxdb_connect_error());
exit();
}
$query = "SELECT name, state FROM hotel.city ORDER by zip";
if ($result = maxdb_query($link, $query)) {
/* fetch associative array */
while ($obj = maxdb_fetch_object($result)) {
printf ("%s (%s)\n", $obj->NAME, $obj->STATE);
}
/* free result set */
maxdb_free_result($result);
}
/* close connection */
maxdb_close($link);
?>
]]>
</programlisting>
</example>
<para>
The above examples would produce the following output:
</para>
<screen>
<![CDATA[
New York (NY)
New York (NY)
Long Island (NY)
Albany (NY)
Washington (DC)
Washington (DC)
Washington (DC)
Silver Spring (MD)
Daytona Beach (FL)
Deerfield Beach (FL)
Clearwater (FL)
Cincinnati (OH)
Detroit (MI)
Rosemont (IL)
Chicago (IL)
Chicago (IL)
New Orleans (LA)
Dallas (TX)
Los Angeles (CA)
Hollywood (CA)
Long Beach (CA)
Palm Springs (CA)
Irvine (CA)
Santa Clara (CA)
Portland (OR)
]]>
</screen>
</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
-->