function append ($list)
  {
    $cur = $this->getIterator ();
    if ($cur instanceof AppendIterator) {
      foreach (iterator ($list) as $it)
        $cur->append (iterator ($it));
    }
    else {
      $a = new AppendIterator;
      $a->append ($cur);
      foreach (iterator ($list) as $it)
        $a->append (iterator ($it));
      $this->setIterator ($a);
    }
    return $this;
  }
function append ($list)
  {
    $cur = $this->getIterator ();
    if ($cur instanceof AppendIterator) {
      foreach (iterator ($list) as $it)
        $cur->append (iterator ($it));
    }
    else {
      $a = new AppendIterator;
      $a->append ($cur);
      foreach (iterator ($list) as $it)
        $a->append (iterator ($it));
      $this->setIterator ($a);
    }
    return $this;
  }
function append ( $ list ) { $ cur = $ this -> getIterator ( ) ; if ( $ cur instanceof AppendIterator ) { foreach ( iterator ( $ list ) as $ it ) $ cur -> append ( iterator ( $ it ) ) ; } else { $ a = new AppendIterator ; $ a -> append ( $ cur ) ; foreach ( iterator ( $ list ) as $ it ) $ a -> append ( iterator ( $ it ) ) ; $ this -> setIterator ( $ a ) ; } return $ this ; }
Appends one or more iterators to the current one and sets a new iterator that iterates over all of them.

<p>**Note:** an optimization is performed if the current iterator is already an {@see AppendIterator}.

> ##### Caution
When using {@see iterator_to_array()} to copy the values of the resulting sequence into an array, you
have to set the optional `use_key` argument to `FALSE`.<br>
When `use_key` is not `FALSE` any keys reoccuring in inner iterators will get overwritten in the returned array.
<p><br>When using {@see Flow::all()} the same problem may occur.<br>
You can use {@see Flow::pack()} or {@see Flow::reindex()} instead, if you need a monotonically increasing
sequence of keys.

@param mixed $list A sequence of iterables to append.
@return $this
Appends one or more iterators to the current one and sets a new iterator that iterates over all of them .