php-doc-en/reference/mysqli/functions/mysqli-fetch-object.xml
Georg Richter 3eb2dcea98 added more samples
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@152070 c90b9560-bf6c-de11-be94-00142212c4b1
2004-02-22 09:40:50 +00:00

122 lines
3.4 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<refentry id="function.mysqli-fetch-object">
<refnamediv>
<refname>mysqli_fetch_object</refname>
<refname>result->fetch_object</refname>
<refpurpose>Returns the current row of a result set as an object</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<para>Procedural style:</para>
<methodsynopsis>
<type>mixed</type><methodname>mysqli_fetch_object</methodname>
<methodparam><type>object</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>Object oriented style (method):</para>
<classsynopsis>
<ooclass><classname>result</classname></ooclass>
<methodsynopsis>
<type>mixed</type>
<methodname>fetch_object</methodname>
<methodparam><type>void</type><parameter></parameter></methodparam>
</methodsynopsis>
</classsynopsis>
<para>
The <function>mysqli_fetch_object</function> will return the current row result set
as an object where the attributes of the object represent the names of the fields found
within the result set. If no more rows exist in the current result set, &false; is returned.
</para>
</refsect1>
<refsect1>
<title>Return values</title>
<para>
Returns an object that corresponds to the fetched row or &null; if there are no more rows in resultset.
</para>
&database.field-case;
</refsect1>
<refsect1>
<title>See also</title>
<para>
<function>mysqli_fetch_array</function>,
<function>mysqli_fetch_assoc</function>,
<function>mysqli_fetch_row</function>.
</para>
</refsect1>
<refsect1>
<title>Example</title>
<para>
<example>
<title>Object oriented style</title>
<programlisting role='php'>
<![CDATA[
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "test");
mysqli_query($link, "DROP TABLE IF EXISTS friends");
mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))");
mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");
$result = mysqli_query($link, "SELECT id, name FROM friends");
/* fetch object */
$obj = mysqli_fetch_object($result);
printf("Id: %d Name: %s\n", $obj->id, $obj->name);
mysqli_free_result($result);
mysqli_close($link);
?>
]]>
</programlisting>
</example>
<example>
<title>Procedural style</title>
<programlisting role='php'>
<![CDATA[
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "test");
$mysqli->query( "DROP TABLE IF EXISTS friends");
$mysqli->query( "CREATE TABLE friends (id int, name varchar(20))");
$mysqli->query( "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");
$result = $mysqli->query( "SELECT id, name FROM friends");
/* fetch object */
$obj = $result->fetch_object();
printf("Id: %d Name: %s\n", $obj->id, $obj->name);
$result->close();
$mysqli->close();
?>
]]>
</programlisting>
</example>
</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
-->