function.asort.html 6.11 KB
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
 <head>
  <meta http-equiv="content-type" content="text/html; charset=UTF-8">
  <title>Sortiert ein Array und erh&auml;lt die Index-Assoziation</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.arsort.html">arsort</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.compact.html">compact</a></div>
 <div class="up"><a href="ref.array.html">Array Funktionen</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.asort" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">asort</h1>
  <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">asort</span> &mdash; <span class="dc-title">Sortiert ein Array und erhält die Index-Assoziation</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.asort-description">
  <h3 class="title">Beschreibung</h3>
  <div class="methodsynopsis dc-description">
   <span class="type">bool</span> <span class="methodname"><strong>asort</strong></span>
    ( <span class="methodparam"><span class="type">array</span> <code class="parameter reference">&$array</code></span>
   [, <span class="methodparam"><span class="type">int</span> <code class="parameter">$sort_flags</code><span class="initializer"> = SORT_REGULAR</span></span>
  ] )</div>

  <p class="para rdfs-comment">
   Diese Funktion sortiert ein Array so, dass der Zusammenhang
   zwischen den Indizes und den entsprechenden Elementen des Arrays
   erhalten bleibt. Dies wird hauptsächlich zur Sortierung assoziativer
   Arrays verwendet, bei denen die aktuelle Reihenfolge der Elemente
   bedeutend ist.
  </p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.asort-parameters">
  <h3 class="title">Parameter-Liste</h3>
  <p class="para">
   <dl>

    
     <dt>
<code class="parameter">array</code></dt>

     <dd>

      <p class="para">
       Das Eingabe-Array.
      </p>
     </dd>

    
    
     <dt>
<code class="parameter">sort_flags</code></dt>

     <dd>

      <p class="para">
       Sie können das Verhalten der Sortierung mittels dem optionalen
       Parameter <code class="parameter">sort_flags</code> beeinflussen, für
       Details siehe <span class="function"><a href="function.sort.html" class="function">sort()</a></span>.
      </p>
     </dd>

    
   </dl>

  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.asort-returnvalues">
  <h3 class="title">Rückgabewerte</h3>
  <p class="para">
   Gibt bei Erfolg <strong><code>TRUE</code></strong> zurück. Im Fehlerfall wird <strong><code>FALSE</code></strong> zurückgegeben.
  </p>
 </div>

 <div class="refsect1 examples" id="refsect1-function.asort-examples">
  <h3 class="title">Beispiele</h3>
  <p class="para">
   <div class="example" id="example-4962">
    <p><strong>Beispiel #1 <span class="function"><strong>asort()</strong></span>-Beispiel</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$fruits&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #DD0000">"d"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"Zitrone"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"a"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"Orange"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"b"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"Banane"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"c"&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #DD0000">"Apfel"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">asort</span><span style="color: #007700">(</span><span style="color: #0000BB">$fruits</span><span style="color: #007700">);<br />foreach&nbsp;(</span><span style="color: #0000BB">$fruits&nbsp;</span><span style="color: #007700">as&nbsp;</span><span style="color: #0000BB">$key&nbsp;</span><span style="color: #007700">=&gt;&nbsp;</span><span style="color: #0000BB">$val</span><span style="color: #007700">)&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;echo&nbsp;</span><span style="color: #DD0000">"</span><span style="color: #0000BB">$key</span><span style="color: #DD0000">&nbsp;=&nbsp;</span><span style="color: #0000BB">$val</span><span style="color: #DD0000">\n"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:</p></div>
    <div class="example-contents screen">
<div class="cdata"><pre>
c = Apfel
b = Banane
a = Orange
d = Zitrone
</pre></div>
    </div>
    <div class="example-contents"><p>
     Die Früchte wurden alphabetisch sortiert und die Zuordnung
     zwischen Index und Element blieb erhalten.
    </p></div>
   </div>
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.asort-seealso">
  <h3 class="title">Siehe auch</h3>
  <p class="para">
   <ul class="simplelist">
    <li class="member"><span class="function"><a href="function.arsort.html" class="function" rel="rdfs-seeAlso">arsort()</a> - Sortiert ein Array in umgekehrter Reihenfolge und erh&auml;lt die
   Index-Assoziation</span></li>
    <li class="member">Den <a href="array.sorting.html" class="link">Vergleich von Arraysortierungsfunktionen</a></li>
   </ul>
  </p>
 </div>

</div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.arsort.html">arsort</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.compact.html">compact</a></div>
 <div class="up"><a href="ref.array.html">Array Funktionen</a></div>
 <div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>