mysql-result.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: simp Status: ready -->
<!-- Credits: hholzgra -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-result">
 <refnamediv>
  <refname>mysql_result</refname>
  <refpurpose>Liefert eine Spalte aus einem MySQL-Ergebnis</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
   <warning>
    &mysql.alternative.note;
    <simplelist role="alternatives">
     <member>
      <function>mysqli_data_seek</function> zusammen mit
      <function>mysqli_field_seek</function> und
      <function>mysqli_fetch_field</function>
     </member>
     <member><methodname>PDOStatement::fetchColumn</methodname></member>
    </simplelist>
   </warning>
  </refsynopsisdiv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>mysql_result</methodname>
   <methodparam><type>resource</type><parameter>result</parameter></methodparam>
   <methodparam><type>int</type><parameter>row</parameter></methodparam>
   <methodparam choice="opt"><type>mixed</type><parameter>field</parameter><initializer>0</initializer></methodparam>
  </methodsynopsis>
  <simpara>
   Gibt den Inhalt einer Spalte aus einer MySQL-Ergebnismenge zurück.
  </simpara>
  <simpara>
   Wenn auf Abfrageergebnisse mit vielen Datensätzen zugegriffen werden soll,
   sollten Sie Funktionen in Betracht ziehen, die auf ganze Datensätze
   zugreifen (siehe unten). Diese Funktionen liefern bei einem einzigen Aufruf
   den Inhalt mehrerer Spalten und sind aus diesem Grund SEHR viel schneller
   als <function>mysql_result</function>. Beachten Sie auch, dass die Angabe
   eines numerischen Offsets für eine Spalte sehr viel schneller ist als die
   Angabe eines Spaltennamens oder tabellenname.spaltenname.
  </simpara>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <variablelist>
   &mysql.result.description;
   <varlistentry>
    <term><parameter>row</parameter></term>
    <listitem>
     <simpara>
      Die Zeilennummer des erhaltenen Ergebnisses. Zeilennummern beginnen mit
      <literal>0</literal>.
     </simpara>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>field</parameter></term>
    <listitem>
     <simpara>
      Der Name oder der Offset der abzurufenden Spalte (Feld).
     </simpara>
     <simpara>
      Dies kann der Offset der Spalte sein, der Name der Spalte oder ein
      Bezeichner in der Form Tabellenname.Spaltenname. Wurde ein Alias für
      den Spaltennamen verwendet ('select foo as bar from...'), verwenden Sie
      stattdessen den Alias. Ist der Wert nicht definiert, wird die erste
      Spalte zurückgegeben.
     </simpara>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <simpara>
   Gibt bei Erfolg die Inhalte einer Spalte einer MySQL-Ergebnismenge zurück
   oder &false; bei Fehlern.
  </simpara>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <example>
   <title><function>mysql_result</function>-Beispiel</title>
   <programlisting role="php">
<![CDATA[
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
    die('Keine Verbindung möglich: ' . mysql_error());
}
if (!mysql_select_db('database_name')) {
    die('Konnte Datenbank nicht auswählen: ' . mysql_error());
}
$result = mysql_query('SELECT name FROM work.employee');
if (!$result) {
    die('Konnte Abfrage nicht ausführen:' . mysql_error());
}
echo mysql_result($result, 2); // gibt den Namen des dritten Angestellten aus

mysql_close($link);
?>
]]>
   </programlisting>
  </example>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <simpara>
    Aufrufe von <function>mysql_result</function> sollten nicht mit Aufrufen
    anderer Funktionen verschachtelt werden, die auch auf das Ergebnis
    zugreifen.
   </simpara>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <simplelist>
   <member><function>mysql_fetch_row</function></member>
   <member><function>mysql_fetch_array</function></member>
   <member><function>mysql_fetch_assoc</function></member>
   <member><function>mysql_fetch_object</function></member>
  </simplelist>
 </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
-->