mirror of
				https://github.com/python/cpython.git
				synced 2025-11-03 19:34:08 +00:00 
			
		
		
		
	bpo-32099 Add deque variant of roundrobin() recipe (#4497)
* Minor wording tweaks
This commit is contained in:
		
							parent
							
								
									dcaed6b2d9
								
							
						
					
					
						commit
						0858495a50
					
				
					 1 changed files with 19 additions and 0 deletions
				
			
		| 
						 | 
					@ -618,6 +618,25 @@ added elements by appending to the right and popping to the left::
 | 
				
			||||||
            d.append(elem)
 | 
					            d.append(elem)
 | 
				
			||||||
            yield s / n
 | 
					            yield s / n
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					A `round-robin scheduler
 | 
				
			||||||
 | 
					<https://en.wikipedia.org/wiki/Round-robin_scheduling>`_ can be implemented with
 | 
				
			||||||
 | 
					input iterators stored in a :class:`deque`.  Values are yielded from the active
 | 
				
			||||||
 | 
					iterator in position zero.  If that iterator is exhausted, it can be removed
 | 
				
			||||||
 | 
					with :meth:`~deque.popleft`; otherwise, it can be cycled back to the end with
 | 
				
			||||||
 | 
					the :meth:`~deque.rotate` method::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    def roundrobin(*iterables):
 | 
				
			||||||
 | 
					        "roundrobin('ABC', 'D', 'EF') --> A D E B F C"
 | 
				
			||||||
 | 
					        iterators = deque(map(iter, iterables))
 | 
				
			||||||
 | 
					        while iterators:
 | 
				
			||||||
 | 
					            try:
 | 
				
			||||||
 | 
					                while True:
 | 
				
			||||||
 | 
					                    yield next(iterators[0])
 | 
				
			||||||
 | 
					                    iterators.rotate(-1)
 | 
				
			||||||
 | 
					            except StopIteration:
 | 
				
			||||||
 | 
					                # Remove an exhausted iterator.
 | 
				
			||||||
 | 
					                iterators.popleft()
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The :meth:`rotate` method provides a way to implement :class:`deque` slicing and
 | 
					The :meth:`rotate` method provides a way to implement :class:`deque` slicing and
 | 
				
			||||||
deletion.  For example, a pure Python implementation of ``del d[n]`` relies on
 | 
					deletion.  For example, a pure Python implementation of ``del d[n]`` relies on
 | 
				
			||||||
the :meth:`rotate` method to position elements to be popped::
 | 
					the :meth:`rotate` method to position elements to be popped::
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue