<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.generators.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'language.generators.comparison.php',
    1 => 'Vergleich von Generatoren mit Iterator-Objekten',
    2 => 'Vergleich von Generatoren mit Iterator-Objekten',
  ),
  'up' => 
  array (
    0 => 'language.generators.php',
    1 => 'Generatoren',
  ),
  'prev' => 
  array (
    0 => 'language.generators.syntax.php',
    1 => 'Generator-Syntax',
  ),
  'next' => 
  array (
    0 => 'language.attributes.php',
    1 => 'Attribute',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    'path' => 'language/generators.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.generators.comparison" class="sect1">
  <h2 class="title">Vergleich von Generatoren mit <span class="classname"><a href="class.iterator.php" class="classname">Iterator</a></span>-Objekten</h2>

  <p class="para">
   Der Hauptvorteil von Generatoren ist deren Einfachheit. Viel weniger
   Boilerplate-Code muss geschrieben werden als im Vergleich zur
   Implementierung einer <span class="classname"><a href="class.iterator.php" class="classname">Iterator</a></span>-Klasse und der Code
   ist generell einfacher zu lesen. Zum Beispiel sind die folgende Funktion und
   Klasse äquivalent:
  </p>

  <div class="informalexample">
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">leseZeilenVonDatei</span><span style="color: #007700">(</span><span style="color: #0000BB">$dateiName</span><span style="color: #007700">) {<br />    if (!</span><span style="color: #0000BB">$dateiHandle </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen</span><span style="color: #007700">(</span><span style="color: #0000BB">$dateiName</span><span style="color: #007700">, </span><span style="color: #DD0000">'r'</span><span style="color: #007700">)) {<br />        return;<br />    }<br /><br />    while (</span><span style="color: #0000BB">false </span><span style="color: #007700">!== </span><span style="color: #0000BB">$zeile </span><span style="color: #007700">= </span><span style="color: #0000BB">fgets</span><span style="color: #007700">(</span><span style="color: #0000BB">$dateiHandle</span><span style="color: #007700">)) {<br />        yield </span><span style="color: #0000BB">$zeile</span><span style="color: #007700">;<br />    }<br /><br />    </span><span style="color: #0000BB">fclose</span><span style="color: #007700">(</span><span style="color: #0000BB">$dateiHandle</span><span style="color: #007700">);<br />}<br /><br /></span><span style="color: #FF8000">// im Gegensatz zu...<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">LineIterator </span><span style="color: #007700">implements </span><span style="color: #0000BB">Iterator </span><span style="color: #007700">{<br />class </span><span style="color: #0000BB">LineIterator </span><span style="color: #007700">implements </span><span style="color: #0000BB">Iterator </span><span style="color: #007700">{<br />    protected </span><span style="color: #0000BB">$fileHandle</span><span style="color: #007700">;<br /><br />    protected </span><span style="color: #0000BB">$line</span><span style="color: #007700">;<br />    protected </span><span style="color: #0000BB">$i</span><span style="color: #007700">;<br /><br />    public function </span><span style="color: #0000BB">__construct</span><span style="color: #007700">(</span><span style="color: #0000BB">$fileName</span><span style="color: #007700">) {<br />        if (!</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">fileHandle </span><span style="color: #007700">= </span><span style="color: #0000BB">fopen</span><span style="color: #007700">(</span><span style="color: #0000BB">$fileName</span><span style="color: #007700">, </span><span style="color: #DD0000">'r'</span><span style="color: #007700">)) {<br />            throw new </span><span style="color: #0000BB">RuntimeException</span><span style="color: #007700">(</span><span style="color: #DD0000">'Couldn\'t open file "' </span><span style="color: #007700">. </span><span style="color: #0000BB">$fileName </span><span style="color: #007700">. </span><span style="color: #DD0000">'"'</span><span style="color: #007700">);<br />        }<br />    }<br /><br />    public function </span><span style="color: #0000BB">rewind</span><span style="color: #007700">() {<br />        </span><span style="color: #0000BB">fseek</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">fileHandle</span><span style="color: #007700">, </span><span style="color: #0000BB">0</span><span style="color: #007700">);<br />        </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">line </span><span style="color: #007700">= </span><span style="color: #0000BB">fgets</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">fileHandle</span><span style="color: #007700">);<br />        </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">i </span><span style="color: #007700">= </span><span style="color: #0000BB">0</span><span style="color: #007700">;<br />    }<br /><br />    public function </span><span style="color: #0000BB">valid</span><span style="color: #007700">() {<br />        return </span><span style="color: #0000BB">false </span><span style="color: #007700">!== </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">line</span><span style="color: #007700">;<br />    }<br /><br />    public function </span><span style="color: #0000BB">current</span><span style="color: #007700">() {<br />        return </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">line</span><span style="color: #007700">;<br />    }<br /><br />    public function </span><span style="color: #0000BB">key</span><span style="color: #007700">() {<br />        return </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">i</span><span style="color: #007700">;<br />    }<br /><br />    public function </span><span style="color: #0000BB">next</span><span style="color: #007700">() {<br />        if (</span><span style="color: #0000BB">false </span><span style="color: #007700">!== </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">line</span><span style="color: #007700">) {<br />            </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">line </span><span style="color: #007700">= </span><span style="color: #0000BB">fgets</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">fileHandle</span><span style="color: #007700">);<br />            </span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">i</span><span style="color: #007700">++;<br />        }<br />    }<br /><br />    public function </span><span style="color: #0000BB">__destruct</span><span style="color: #007700">() {<br />        </span><span style="color: #0000BB">fclose</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">fileHandle</span><span style="color: #007700">);<br />    }<br />}<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>

  <p class="para">
   Diese Flexibilität kommt allerdings nicht ohne Preis: Generatoren sind
   forward-only-Iteratoren, und können nicht zurückgesetzt werden, wenn sie
   einmal gestartet wurden. Das heißt außerdem, dass der selbe Generator nicht
   mehrfach iteriert werden kann: der Generator muss durch einen
   erneuten Aufruf der Generator-Funktion neu erstellt werden.
  </p>

  <div class="simplesect">
   <h3 class="title">Siehe auch</h3>
   <p class="para">
    <ul class="simplelist">
     <li><a href="language.oop5.iterations.php" class="link">Objektiteration</a></li>
    </ul>
   </p>
  </div>

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