mysql-fetch-object.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ff4017b6334dae2d5353fe99df8089a828795324 Maintainer: simp Status: ready -->
<!-- Credits: wiesemann -->
<refentry xml:id="function.mysql-fetch-object" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>mysql_fetch_object</refname>
  <refpurpose>Liefert eine Ergebniszeile als Objekt</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <warning>
   &mysql.alternative.note;
   <simplelist role="alternatives">
    <member><function>mysqli_fetch_object</function></member>
    <member>
     <methodname>PDOStatement::fetch</methodname>
     mit <constant>PDO::FETCH_OBJ</constant> als <parameter>mode</parameter>
    </member>
   </simplelist>
  </warning>
 </refsynopsisdiv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>object</type><methodname>mysql_fetch_object</methodname>
   <methodparam><type>resource</type><parameter>result</parameter></methodparam>
   <methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam>
   <methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam>
  </methodsynopsis>
  <para>
   Gibt ein Objekt mit Eigenschaften zurück, die mit der angeforderten Zeile
   korrespondieren, und bewegt den internen Datenzeiger vorwärts.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    &mysql.result.description;
    <varlistentry>
     <term><parameter>class_name</parameter></term>
      <listitem>
       <para>
        Der Name der Klasse, die instanziiert, mit Eigenschaften versehen und
        zurückgegeben werden soll. Wenn nicht angegeben, wird ein
        <classname>stdClass</classname>-Objekt zurückgegeben.
       </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>params</parameter></term>
      <listitem>
       <para>
        Ein optionales Array von Parametern, die dem Konstruktor von
        <parameter>class_name</parameter>-Objekten übergeben werden sollen.
       </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Gibt ein &object; mit Eigenschaften zurück, die mit der angeforderten Zeile
   korrespondieren, oder &false; wenn es keine weiteren Zeilen mehr gibt.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>mysql_fetch_object</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
mysql_connect("hostname", "benutzer", "passwort");
mysql_select_db("meinedatenbank");
$result = mysql_query("select * from meinetabelle");
while ($row = mysql_fetch_object($result)) {
    echo $row->user_id;
    echo $row->vollername;
}
mysql_free_result($result);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title><function>mysql_fetch_object</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
class foo {
    public $name;
}

mysql_connect("hostname", "benutzer", "passwort");
mysql_select_db("meinedatenbank");

$result = mysql_query("select name from meinetabelle limit 1");
$obj = mysql_fetch_object($result, 'foo');
var_dump($obj);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <title>Performanz</title>
   <para>
    Unter Berücksichtigung der Ausführungsgeschwindigkeit ist diese Funktion
    identisch zu <function>mysql_fetch_array</function> und fast so schnell
    wie <function>mysql_fetch_row</function> (der Unterschied ist
    unwesentlich).
   </para>
  </note>
  <note>
   <para>
    <function>mysql_fetch_object</function> ist vergleichbar mit
    <function>mysql_fetch_array</function>, mit dem Unterschied, dass ein
    Objekt statt eines Arrays zurückgegeben wird. Indirekt bedeutet das, dass
    Sie auf die Daten nur über die Feldnamen zugreifen können und nicht über
    die Offsets (da Zahlen keine erlaubten Namen für Eigenschaften sind).
   </para>
  </note>
  &database.field-case;
  &database.fetch-null;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mysql_fetch_array</function></member>
    <member><function>mysql_fetch_assoc</function></member>
    <member><function>mysql_fetch_row</function></member>
    <member><function>mysql_data_seek</function></member>
    <member><function>mysql_query</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
indent-tabs-mode:nil
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
-->