From e44c06c14efb91b1dc56841f7791a2a6dff56986 Mon Sep 17 00:00:00 2001
From: Marcus Boerger <helly@php.net>
Date: Tue, 27 Apr 2004 18:15:00 +0000
Subject: [PATCH] - More examples

---
 ext/spl/examples/emptyiterator.inc    | 37 +++++++++++++++
 ext/spl/examples/infiniteiterator.inc | 67 +++++++++++++++++++++++++++
 2 files changed, 104 insertions(+)
 create mode 100755 ext/spl/examples/emptyiterator.inc
 create mode 100755 ext/spl/examples/infiniteiterator.inc

diff --git a/ext/spl/examples/emptyiterator.inc b/ext/spl/examples/emptyiterator.inc
new file mode 100755
index 00000000000..34b5118e741
--- /dev/null
+++ b/ext/spl/examples/emptyiterator.inc
@@ -0,0 +1,37 @@
+<?php
+
+/**
+ * @brief   An empty Iterator
+ * @author  Marcus Boerger
+ * @version 1.0
+ *
+ */
+class EmptyIterator implements Iterator
+{
+	function rewind()
+	{
+		// nothing to do
+	}
+
+	function valid()
+	{
+		return false;
+	}
+
+	function current()
+	{
+		throw new Exception('Accessing the value of an EmptyIterator');
+	}
+
+	function key()
+	{
+		throw new Exception('Accessing the key of an EmptyIterator');
+	}
+
+	function next()
+	{
+		// nothing to do
+	}
+}
+
+?>
\ No newline at end of file
diff --git a/ext/spl/examples/infiniteiterator.inc b/ext/spl/examples/infiniteiterator.inc
new file mode 100755
index 00000000000..d6488750b6d
--- /dev/null
+++ b/ext/spl/examples/infiniteiterator.inc
@@ -0,0 +1,67 @@
+<?php
+
+/**
+ * @brief   An infinite Iterator
+ * @author  Marcus Boerger
+ * @version 1.0
+ *
+ * This Iterator takes another Iterator and infinitvely iterates it by
+ * rewinding it when its end is reached.
+ *
+ * \note Even an InfiniteIterator stops if its inner Iterator is empty.
+ *
+ \verbatim
+ $it       = new ArrayIterator(array(1,2,3));
+ $infinite = new InfiniteIterator($it);
+ $limit    = new LimitIterator($infinite, 0, 5);
+ foreach($limit as $val=>$key)
+ {
+ 	echo "$val=>$key\n";
+ }
+ \endverbatim
+ */
+class InfiniteIterator implements Iterator
+{
+	private $it;
+
+	function __construct(Iterator $it)
+	{
+		$this->it = $it;
+	}
+
+	function getInnerIterator()
+	{
+		return $this->it;
+	}
+
+	function rewind()
+	{
+		$this->it->rewind();
+	}
+
+	function valid()
+	{
+		return $this->it->valid();
+	}
+
+	function current()
+	{
+		return $this->it->current();
+	}
+
+	function key()
+	{
+		return $this->it->key();
+	}
+
+	function next()
+	{
+		$this->it->next();
+		if (!$this->it->valid())
+		{
+			$this->it->rewind();
+		}
+	}
+}
+
+?>
\ No newline at end of file