Deque

gto76 · gto76 · commit 96f2f7c5a4ff · 2019-06-29T19:53:18.000+02:00
diff --git a/README.md b/README.md
@@ -1572,7 +1572,7 @@ Memory View
 
 Deque
 -----
-**Thread-safe list with efficient appends and pops from either side. Pronounced "deck".**
+**A thread-safe list with efficient appends and pops from either side. Pronounced "deck".**
 
 ```python
 from collections import deque
@@ -1589,6 +1589,16 @@ from collections import deque
 <deque>.rotate(n=1)               # Rotates elements to the right.
 ```
 
+```python
+>>> a = deque([1, 2, 3], maxlen=3)
+>>> a.append(4)
+[2, 3, 4]
+>>> a.appendleft(5)
+[5, 2, 3]
+>>> a.insert(6, 1)
+IndexError: deque already at its maximum size
+```
+
 
 Threading
 ---------
diff --git a/index.html b/index.html
@@ -1362,7 +1362,7 @@ <h2 id="memoryview"><a href="#memoryview" name="memoryview">#</a>Memory View</h2
 &lt;memoryview&gt;.release()
 </code></pre>
 <h2 id="deque"><a href="#deque" name="deque">#</a>Deque</h2>
-<p><strong>Thread-safe list with efficient appends and pops from either side. Pronounced "deck".</strong></p>
+<p><strong>A thread-safe list with efficient appends and pops from either side. Pronounced "deck".</strong></p>
 <pre><code class="python language-python hljs"><span class="hljs-keyword">from</span> collections <span class="hljs-keyword">import</span> deque
 &lt;deque&gt; = deque(&lt;collection&gt;, maxlen=<span class="hljs-keyword">None</span>)
 </code></pre>
@@ -1372,6 +1372,14 @@ <h2 id="deque"><a href="#deque" name="deque">#</a>Deque</h2>
 <pre><code class="python language-python hljs">&lt;deque&gt;.extendleft(&lt;collection&gt;)  <span class="hljs-comment"># Collection gets reversed.</span>
 &lt;deque&gt;.rotate(n=<span class="hljs-number">1</span>)               <span class="hljs-comment"># Rotates elements to the right.</span>
 </code></pre>
+<pre><code class="python language-python hljs"><span class="hljs-meta">&gt;&gt;&gt; </span>a = deque([<span class="hljs-number">1</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span>], maxlen=<span class="hljs-number">3</span>)
+<span class="hljs-meta">&gt;&gt;&gt; </span>a.append(<span class="hljs-number">4</span>)
+[<span class="hljs-number">2</span>, <span class="hljs-number">3</span>, <span class="hljs-number">4</span>]
+<span class="hljs-meta">&gt;&gt;&gt; </span>a.appendleft(<span class="hljs-number">5</span>)
+[<span class="hljs-number">5</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span>]
+<span class="hljs-meta">&gt;&gt;&gt; </span>a.insert(<span class="hljs-number">6</span>, <span class="hljs-number">1</span>)
+IndexError: deque already at its maximum size
+</code></pre>
 <h2 id="threading"><a href="#threading" name="threading">#</a>Threading</h2>
 <pre><code class="python language-python hljs"><span class="hljs-keyword">from</span> threading <span class="hljs-keyword">import</span> Thread, RLock
 </code></pre>
