Python next()

5/5 - (3 votes)

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:

Python next() -- A Simple Guide By Example

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!

Coders get paid six figures and more because they can solve problems more effectively using machine intelligence and automation.

To become more successful in coding, solve more real problems for real people. 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?

You build high-value coding skills by working on practical coding projects!

Do you want to stop learning with toy projects and focus on practical code projects that earn you money and solve real problems for people?

🚀 If your answer is YES!, consider becoming 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.

If you just want to learn about the freelancing opportunity, feel free to watch my free webinar “How to Build Your High-Income Skill Python” and learn how I grew my coding business online and how you can, too—from the comfort of your own home.

Join the free webinar now!