<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.mysql.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'function.mysql-fetch-array.php',
    1 => 'mysql_fetch_array',
    2 => 'Liefert einen Datensatz als assoziatives Array, als numerisches Array oder
   beides',
  ),
  'up' => 
  array (
    0 => 'ref.mysql.php',
    1 => 'MySQL Funktionen',
  ),
  'prev' => 
  array (
    0 => 'function.mysql-escape-string.php',
    1 => 'mysql_escape_string',
  ),
  'next' => 
  array (
    0 => 'function.mysql-fetch-assoc.php',
    1 => 'mysql_fetch_assoc',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    'path' => 'reference/mysql/functions/mysql-fetch-array.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mysql-fetch-array" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mysql_fetch_array</h1>
  <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">mysql_fetch_array</span> &mdash; <span class="dc-title">
   Liefert einen Datensatz als assoziatives Array, als numerisches Array oder
   beides
  </span></p>

 </div>

 <div id="function.mysql-fetch-array-refsynopsisdiv">
  <div class="warning"><strong class="warning">Warnung</strong>
   <p class="para">Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt.
Verwenden Sie stattdessen die Erweiterungen <a href="book.mysqli.php" class="link">MySQLi</a> oder <a href="ref.pdo-mysql.php" class="link">PDO_MySQL</a>.
Weitere Informationen bietet der Ratgeber <a href="mysqlinfo.api.choosing.php" class="link">MySQL: Auswahl einer API</a>.
Alternativen zu dieser Funktion umfassen:</p>
   <ul class="simplelist">
    <li><span class="function"><a href="mysqli-result.fetch-array.php" class="function">mysqli_fetch_array()</a></span></li>
    <li><span class="methodname"><a href="pdostatement.fetch.php" class="methodname">PDOStatement::fetch()</a></span></li>
   </ul>
  </div>
 </div>

 <div class="refsect1 description" id="refsect1-function.mysql-fetch-array-description">
  <h3 class="title">Beschreibung</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mysql_fetch_array</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> <code class="parameter">$result</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$result_type</code><span class="initializer"> = MYSQL_BOTH</span></span>): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>

  <p class="simpara">
   Gibt ein Array zurück, das dem gelesenen Datensatz entspricht und bewegt
   den internen Datenzeiger um einen Schritt vorwärts.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mysql-fetch-array-parameters">
  <h3 class="title">Parameter-Liste</h3>
  <dl>
   <dt>
<code class="parameter">result</code></dt><dd><p class="para">Das Ergebnis
<span class="type">Ressource</span>, das ausgewertet wird. Dieses Ergebnis kommt von einem
Aufruf von
<span class="function"><a href="function.mysql-query.php" class="function">mysql_query()</a></span>.</p></dd>
   
    <dt><code class="parameter">result_type</code></dt>
    <dd>
     <span class="simpara">
      Der Typ des Arrays, das gelesen werden soll. Er ist eine Konstante, die
      folgende Werte haben kann: <strong><code><a href="mysql.constants.php#constant.mysql-assoc">MYSQL_ASSOC</a></code></strong>,
      <strong><code><a href="mysql.constants.php#constant.mysql-num">MYSQL_NUM</a></code></strong> und <strong><code><a href="mysql.constants.php#constant.mysql-both">MYSQL_BOTH</a></code></strong>.
     </span>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mysql-fetch-array-returnvalues">
  <h3 class="title">Rückgabewerte</h3>
  <p class="simpara">
   Gibt ein Array von Zeichenketten zurück, das dem gelesenen Datensatz
   entspricht oder <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> falls keine weiteren Datensätze vorhanden sind. Der
   Typ des zurückgegebenen Arrays hängt davon ab, wie
   <code class="parameter">result_type</code> definiert ist. Verwenden sie
   <strong><code><a href="mysql.constants.php#constant.mysql-both">MYSQL_BOTH</a></code></strong> (Standard), erhalten sie ein Array mit
   sowohl assoziativen als auch numerischen Indizes. Verwenden sie
   <strong><code><a href="mysql.constants.php#constant.mysql-assoc">MYSQL_ASSOC</a></code></strong> erhalten sie nur assoziative Indizes (wie
   bei der Funktion <span class="function"><a href="function.mysql-fetch-assoc.php" class="function">mysql_fetch_assoc()</a></span>), mit
   <strong><code><a href="mysql.constants.php#constant.mysql-num">MYSQL_NUM</a></code></strong> erhalten sie nur numerische Indizes (wie bei
   der Funktion <span class="function"><a href="function.mysql-fetch-row.php" class="function">mysql_fetch_row()</a></span>).
  </p>
  <p class="simpara">
   Falls zwei oder mehrere Spalten des Ergebnisses den gleichen Feldnamen
   haben, dann wird nur der Wert der letzten Spalte im Array unter diesem
   Feldnamen abgelegt. Um auch auf die anderen gleichnamigen Spalten zugreifen
   zu können, müssen Sie den numerischen Index der Spalte verwenden oder einen
   Alias für die Spalte vergeben. Falls Sie Aliase für Spalten verwenden,
   können Sie auf die Inhalte dieser Spalten nicht über ihren ursprünglichen
   Namen zugreifen.
  </p>
 </div>


<div class="refsect1 examples" id="refsect1-function.mysql-fetch-array-examples">
  <h3 class="title">Beispiele</h3>
  <div class="example" id="example-1">
   <p><strong>Beispiel #1 Abfrage mit alias für identische Feldnamen</strong></p>
   <div class="example-contents">
<div class="sqlcode"><pre class="sqlcode">SELECT table1.field AS foo, table2.field AS bar FROM table1, table2</pre>
</div>
   </div>

  </div>
  <div class="example" id="example-2">
   <p><strong>Beispiel #2 <span class="function"><strong>mysql_fetch_array()</strong></span> mit <strong><code><a href="mysql.constants.php#constant.mysql-num">MYSQL_NUM</a></code></strong></strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #DD0000">"mysql_user"</span><span style="color: #007700">, </span><span style="color: #DD0000">"mysql_password"</span><span style="color: #007700">) or<br />    die(</span><span style="color: #DD0000">"Keine Verbindung möglich: " </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br /></span><span style="color: #0000BB">mysql_select_db</span><span style="color: #007700">(</span><span style="color: #DD0000">"mydb"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_query</span><span style="color: #007700">(</span><span style="color: #DD0000">"SELECT id, name FROM mytable"</span><span style="color: #007700">);<br /><br />while (</span><span style="color: #0000BB">$row </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_fetch_array</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">, </span><span style="color: #0000BB">MYSQL_NUM</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"ID: %s  Name: %s"</span><span style="color: #007700">, </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]);<br />}<br /><br /></span><span style="color: #0000BB">mysql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
  <div class="example" id="example-3">
   <p><strong>Beispiel #3 <span class="function"><strong>mysql_fetch_array()</strong></span> mit <strong><code><a href="mysql.constants.php#constant.mysql-assoc">MYSQL_ASSOC</a></code></strong></strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #DD0000">"mysql_user"</span><span style="color: #007700">, </span><span style="color: #DD0000">"mysql_password"</span><span style="color: #007700">) or<br />    die(</span><span style="color: #DD0000">"Keine Verbindung möglich: " </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br /></span><span style="color: #0000BB">mysql_select_db</span><span style="color: #007700">(</span><span style="color: #DD0000">"mydb"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_query</span><span style="color: #007700">(</span><span style="color: #DD0000">"SELECT id, name FROM mytable"</span><span style="color: #007700">);<br /><br />while (</span><span style="color: #0000BB">$row </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_fetch_array</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">, </span><span style="color: #0000BB">MYSQL_ASSOC</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">printf</span><span style="color: #007700">(</span><span style="color: #DD0000">"ID: %s  Name: %s"</span><span style="color: #007700">, </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"id"</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"name"</span><span style="color: #007700">]);<br />}<br /><br /></span><span style="color: #0000BB">mysql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
  <div class="example" id="example-4">
   <p><strong>Beispiel #4 <span class="function"><strong>mysql_fetch_array()</strong></span> mit <strong><code><a href="mysql.constants.php#constant.mysql-both">MYSQL_BOTH</a></code></strong></strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />mysql_connect</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #DD0000">"mysql_user"</span><span style="color: #007700">, </span><span style="color: #DD0000">"mysql_password"</span><span style="color: #007700">) or<br />    die(</span><span style="color: #DD0000">"Keine Verbindung möglich: " </span><span style="color: #007700">. </span><span style="color: #0000BB">mysql_error</span><span style="color: #007700">());<br /></span><span style="color: #0000BB">mysql_select_db</span><span style="color: #007700">(</span><span style="color: #DD0000">"mydb"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$result </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_query</span><span style="color: #007700">(</span><span style="color: #DD0000">"SELECT id, name FROM mytable"</span><span style="color: #007700">);<br /><br />while (</span><span style="color: #0000BB">$row </span><span style="color: #007700">= </span><span style="color: #0000BB">mysql_fetch_array</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">, </span><span style="color: #0000BB">MYSQL_BOTH</span><span style="color: #007700">)) {<br />    </span><span style="color: #0000BB">printf </span><span style="color: #007700">(</span><span style="color: #DD0000">"ID: %s  Name: %s"</span><span style="color: #007700">, </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">], </span><span style="color: #0000BB">$row</span><span style="color: #007700">[</span><span style="color: #DD0000">"name"</span><span style="color: #007700">]);<br />}<br /><br /></span><span style="color: #0000BB">mysql_free_result</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>


 <div class="refsect1 notes" id="refsect1-function.mysql-fetch-array-notes">
  <h3 class="title">Anmerkungen</h3>
  <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
   <strong>Performance</strong><br />
   <span class="simpara">
    Zu betonen ist, dass die Verwendung von
    <span class="function"><strong>mysql_fetch_array()</strong></span> <em> nicht
    signifikant</em> langsamer ist als
    <span class="function"><a href="function.mysql-fetch-row.php" class="function">mysql_fetch_row()</a></span>, obwohl die Funktion einen
    sichtlichen Mehrwert bietet.
   </span>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Hinweis</strong>: <span class="simpara">Bei den Spaltennamen, die von
dieser Funktion zurückgegeben werden, wird <em>zwischen Groß- und
Kleinschreibung unterschieden</em>.</span></p></blockquote>
  <blockquote class="note"><p><strong class="note">Hinweis</strong>: <span class="simpara">Diese Funktion setzt NULL-Felder
auf den PHP-Wert <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>.</span></p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.mysql-fetch-array-seealso">
  <h3 class="title">Siehe auch</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.mysql-fetch-row.php" class="function" rel="rdfs-seeAlso">mysql_fetch_row()</a> - Liefert einen Datensatz als indiziertes Array</span></li>
   <li><span class="function"><a href="function.mysql-fetch-assoc.php" class="function" rel="rdfs-seeAlso">mysql_fetch_assoc()</a> - Liefert einen Datensatz als assoziatives Array</span></li>
   <li><span class="function"><a href="function.mysql-data-seek.php" class="function" rel="rdfs-seeAlso">mysql_data_seek()</a> - Bewegt den internen Ergebnis-Zeiger</span></li>
   <li><span class="function"><a href="function.mysql-query.php" class="function" rel="rdfs-seeAlso">mysql_query()</a> - Sendet eine Abfrage an MySQL</span></li>
  </ul>
 </div>


</div><?php manual_footer($setup); ?>