B
    u‹dÙ  ã               @   s$   d Z eZeƒ Zefdd„ZdgZdS )a†  
This module provides a newnext() function in Python 2 that mimics the
behaviour of ``next()`` in Python 3, falling back to Python 2's behaviour for
compatibility if this fails.

``newnext(iterator)`` calls the iterator's ``__next__()`` method if it exists. If this
doesn't exist, it falls back to calling a ``next()`` method.

For example:

    >>> class Odds(object):
    ...     def __init__(self, start=1):
    ...         self.value = start - 2
    ...     def __next__(self):                 # note the Py3 interface
    ...         self.value += 2
    ...         return self.value
    ...     def __iter__(self):
    ...         return self
    ...
    >>> iterator = Odds()
    >>> next(iterator)
    1
    >>> next(iterator)
    3

If you are defining your own custom iterator class as above, it is preferable
to explicitly decorate the class with the @implements_iterator decorator from
``future.utils`` as follows:

    >>> @implements_iterator
    ... class Odds(object):
    ...     # etc
    ...     pass

This next() function is primarily for consuming iterators defined in Python 3
code elsewhere that we would like to run on Python 2 or 3.
c             C   sŒ   yRy|   ¡ S  tk
rN   y|  ¡ S  tk
rH   td | jj¡ƒ‚Y nX Y nX W n4 tk
r† } z|tkrr|‚n|S W dd}~X Y nX dS )z¸
    next(iterator[, default])

    Return the next item from the iterator. If default is given and the iterator
    is exhausted, it is returned instead of raising StopIteration.
    z'{0}' object is not an iteratorN)	Ú__next__ÚAttributeErrorÚnextÚ	TypeErrorÚformatÚ	__class__Ú__name__ÚStopIterationÚ	_SENTINEL)ÚiteratorÚdefaultÚe© r   úd/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/site-packages/future/builtins/newnext.pyÚnewnext+   s    r   N)Ú__doc__r   Z_builtin_nextÚobjectr	   r   Ú__all__r   r   r   r   Ú<module>%   s   