From 041a3d1c4974c6e574bb0b7eee174de976fa0c94 Mon Sep 17 00:00:00 2001
From: Sangeeth Sudheer <sangeeth96@users.noreply.github.com>
Date: Tue, 26 Apr 2022 01:05:08 +0530
Subject: [PATCH] peeking-iterator py3

---
 0284_peeking-iterator/README.md           | 38 +++++++++++++
 0284_peeking-iterator/python3/solution.py | 65 +++++++++++++++++++++++
 2 files changed, 103 insertions(+)
 create mode 100644 0284_peeking-iterator/README.md
 create mode 100644 0284_peeking-iterator/python3/solution.py

diff --git a/0284_peeking-iterator/README.md b/0284_peeking-iterator/README.md
new file mode 100644
index 0000000..ae8fe67
--- /dev/null
+++ b/0284_peeking-iterator/README.md
@@ -0,0 +1,38 @@
+Design an iterator that supports the `peek` operation on an existing iterator in addition to the `hasNext` and the `next` operations.
+
+Implement the `PeekingIterator` class:
+
+*   `PeekingIterator(Iterator<int> nums)` Initializes the object with the given integer iterator `iterator`.
+*   `int next()` Returns the next element in the array and moves the pointer to the next element.
+*   `boolean hasNext()` Returns `true` if there are still elements in the array.
+*   `int peek()` Returns the next element in the array **without** moving the pointer.
+
+**Note:** Each language may have a different implementation of the constructor and `Iterator`, but they all support the `int next()` and `boolean hasNext()` functions.
+
+**Example 1:**
+
+    Input
+    ["PeekingIterator", "next", "peek", "next", "next", "hasNext"]
+    [[[1, 2, 3]], [], [], [], [], []]
+    Output
+    [null, 1, 2, 2, 3, false]
+    
+    Explanation
+    PeekingIterator peekingIterator = new PeekingIterator([1, 2, 3]); // [1,2,3]
+    peekingIterator.next();    // return 1, the pointer moves to the next element [1,2,3].
+    peekingIterator.peek();    // return 2, the pointer does not move [1,2,3].
+    peekingIterator.next();    // return 2, the pointer moves to the next element [1,2,3]
+    peekingIterator.next();    // return 3, the pointer moves to the next element [1,2,3]
+    peekingIterator.hasNext(); // return False
+    
+
+**Constraints:**
+
+*   `1 <= nums.length <= 1000`
+*   `1 <= nums[i] <= 1000`
+*   All the calls to `next` and `peek` are valid.
+*   At most `1000` calls will be made to `next`, `hasNext`, and `peek`.
+
+**Follow up:** How would you extend your design to be generic and work with all types, not just integer?
+
+https://leetcode.com/problems/peeking-iterator
\ No newline at end of file
diff --git a/0284_peeking-iterator/python3/solution.py b/0284_peeking-iterator/python3/solution.py
new file mode 100644
index 0000000..843f7f8
--- /dev/null
+++ b/0284_peeking-iterator/python3/solution.py
@@ -0,0 +1,65 @@
+# Below is the interface for Iterator, which is already defined for you.
+#
+# class Iterator:
+#     def __init__(self, nums):
+#         """
+#         Initializes an iterator object to the beginning of a list.
+#         :type nums: List[int]
+#         """
+#
+#     def hasNext(self):
+#         """
+#         Returns true if the iteration has more elements.
+#         :rtype: bool
+#         """
+#
+#     def next(self):
+#         """
+#         Returns the next element in the iteration.
+#         :rtype: int
+#         """
+
+class PeekingIterator:
+    peeked = None
+    
+    def __init__(self, iterator):
+        """
+        Initialize your data structure here.
+        :type iterator: Iterator
+        """
+        self.it = iterator
+
+    def peek(self):
+        """
+        Returns the next element in the iteration without advancing the iterator.
+        :rtype: int
+        """
+        if self.peeked:
+            return self.peeked
+        
+        self.peeked = self.it.next()
+        return self.peeked
+
+    def next(self):
+        """
+        :rtype: int
+        """
+        if self.peeked:
+            tmp, self.peeked = self.peeked, None
+            return tmp
+        
+        return self.it.next()
+        
+
+    def hasNext(self):
+        """
+        :rtype: bool
+        """
+        return self.peeked is not None or self.it.hasNext()
+        
+
+# Your PeekingIterator object will be instantiated and called as such:
+# iter = PeekingIterator(Iterator(nums))
+# while iter.hasNext():
+#     val = iter.peek()   # Get the next element but not advance the iterator.
+#     iter.next()         # Should return the same value as [val].