function.array-push.html 5.75 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>F&uuml;gt ein oder mehr Elemente an das Ende eines Arrays</title>

 </head>
 <body><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.array-product.html">array_product</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.array-rand.html">array_rand</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.array-push" class="refentry">
   <div class="refnamediv">
    <h1 class="refname">array_push</h1>
    <p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">array_push</span> &mdash; <span class="dc-title">Fügt ein oder mehr Elemente an das Ende eines Arrays</span></p>

   </div>
   <div class="refsect1 description" id="refsect1-function.array-push-description">
    <h3 class="title">Beschreibung</h3>
     <div class="methodsynopsis dc-description">
      <span class="type">int</span> <span class="methodname"><strong>array_push</strong></span>
       ( <span class="methodparam"><span class="type">array</span> <code class="parameter reference">&$array</code></span>
      , <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$var</code></span>
      [, <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$...</code></span>
     ] )</div>

    <p class="para rdfs-comment">
     <span class="function"><strong>array_push()</strong></span> behandelt
     <code class="parameter">array</code> als Stapel (Stack), und fügt die
     übergebenen Variablen an das Ende von
     <code class="parameter">array</code>.  Die Länge von
     <code class="parameter">array</code> wird dabei um die Anzahl der
     angefügten Variablen erhöht. Dies hat den selben Effekt wie:
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$array</span><span style="color: #007700">[]&nbsp;=&nbsp;</span><span style="color: #0000BB">$var</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
     </div>

     für jede Variable <code class="parameter">var</code> wiederholt.
    </p>
    <p class="para">
     Liefert die neue Anzahl Elemente des Arrays.
    </p>
    <p class="para">
     <div class="example" id="example-4932">
      <p><strong>Beispiel #1 <span class="function"><strong>array_push()</strong></span></strong></p>
      <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />$stack&nbsp;</span><span style="color: #007700">=&nbsp;array(</span><span style="color: #DD0000">"Orange"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"Banane"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">array_push</span><span style="color: #007700">(</span><span style="color: #0000BB">$stack</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"Apfel"</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"Himbeere"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$stack</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</code></div>
      </div>

      <div class="example-contents"><p>
       Danach enthält <var class="varname"><var class="varname">$stack</var></var>
       die folgenden Elemente:
      </p></div>
      <div class="example-contents screen">
<div class="cdata"><pre>
Array
(
    [0] =&gt; Orange
    [1] =&gt; Banane
    [2] =&gt; Apfel
    [3] =&gt; Himbeere
)
</pre></div>
      </div>
     </div>
    </p>
    <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
     <span class="simpara">
      Wenn Sie <span class="function"><strong>array_push()</strong></span> verwenden, um ein Element an
      ein Array anzuhängen, ist es besser <em>$array[] = </em> zu
      benutzen, da dies den zusätzlichen Aufwand vermeidet, eine Funktion 
      aufzurufen
     </span>
    </p></blockquote>
    <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
     <span class="simpara">
      <span class="function"><strong>array_push()</strong></span> gibt eine Warung aus, wenn das erste
      Argument kein Array ist. Dies unterscheidet sich vom Verhalten von
      <em>$var[]</em>, welches ein neues Array erzeugt.
     </span>
    </p></blockquote>
    <p class="para">
     Siehe auch <span class="function"><a href="function.array-pop.html" class="function">array_pop()</a></span>,
     <span class="function"><a href="function.array-shift.html" class="function">array_shift()</a></span> und
     <span class="function"><a href="function.array-unshift.html" class="function">array_unshift()</a></span>.
    </p>
   </div>

  </div><hr /><div class="manualnavbar" style="text-align: center;">
 <div class="prev" style="text-align: left; float: left;"><a href="function.array-product.html">array_product</a></div>
 <div class="next" style="text-align: right; float: right;"><a href="function.array-rand.html">array_rand</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>