Python next()

The next(iterator) function is one of Python’s built-in functions—so, you can use it without importing any library. It returns the next value from the iterator you pass as a required first argument. An optional second argument default returns the passed default value in case the iterator doesn’t provide a next value.

Python next()


next(iterator, <default>)


  • iterator – the next element is retrieved from the iterator
  • default (optional) – return value if iterator is exhausted (it doesn’t have a next element)

Related Tutorials:

Example 1: No Default Value

The following example shows the next() function in action—without using a default value in case the iterator is empty.

users = ['Alice', 'Bob', 'Carl', 'David']

# convert the list to an iterator
users_iterator = iter(users)

x = next(users_iterator)
# Output: 'Alice'

x = next(users_iterator)
# Output: 'Bob'

x = next(users_iterator)
# Output: 'Carl'

x = next(users_iterator)
# Output: 'David'

Each time you call next(iterator), the iterator returns the next element in the iterator over the Python list users.

But what happens if you call the next() function once more on the now empty users_iterator object?

x = next(users_iterator)
Traceback (most recent call last):
  File "C:\Users\xcent\Desktop\Finxter\Blog\HowToConvertBooleanToStringPython\", line 22, in <module>
    x = next(users_iterator)

Python throws a StopIteration error.

Let’s learn how to fix this!

Example 2: With Default Value

Not providing Python a solution to the problem that the iterator may be empty is a common source of errors! You can fix the errors by passing the optional default argument:

x = next(users_iterator, 42)
# 42

Now, you cannot crash the next(...) function anymore! Go ahead and try it…

Interactive Shell

The interactive code shell offers you a way to try your newly gained skill—understanding the next() function. Can you crash the script by changing the function arguments?

Exercise: Run the code in the interactive shell. Now, change the default value & run again!

Where to Go From Here?

Enough theory, let’s get some practice!

To become successful in coding, you need to get out there and solve real problems for real people. That’s how you can become a six-figure earner easily. And that’s how you polish the skills you really need in practice. After all, what’s the use of learning theory that nobody ever needs?

Practice projects is how you sharpen your saw in coding!

Do you want to become a code master by focusing on practical code projects that actually earn you money and solve problems for people?

Then become a Python freelance developer! It’s the best way of approaching the task of improving your Python skills—even if you are a complete beginner.

Join my free webinar “How to Build Your High-Income Skill Python” and watch how I grew my coding business online and how you can, too—from the comfort of your own home.

Join the free webinar now!