Overview
Working with multiple values is one of the most common tasks in Python. Before Python can process a collection one element at a time, the collection must be iterable. These objects are known as iterable objects.
In the previous tutorial, you learned that Python iteration processes elements one at a time. However, before iteration can begin, Python must have an object that can supply those elements. Such an object is called an iterable.
Python iterable objects are the starting point of every iteration process. Whether you use a for loop, create an iterator with iter(), or work with many built-in Python functions, the process always begins with an iterable object.
In this tutorial, you will learn what iterable objects are, why they are important, their main characteristics, the different built-in iterable objects available in Python, and how to determine whether an object is iterable. By the end of this tutorial, you will have a solid understanding of iterable objects before moving on to Python iterators.
Quick Navigation
You can use the links below to navigate this tutorial:
- What Are Iterable Objects in Python?
- Why Are Iterable Objects Important?
- Characteristics of Python Iterables
- How Python Iteration Begins with Iterables
- Built-in Iterable Objects in Python
- How to Check Whether an Object Is Iterable
- Examples of Python Iterable Objects
- Common Beginner Mistakes: Iterable Objects
- Key Takeaways: Python Iterables
Introduction: What Are Iterable Objects in Python?
An iterable object is any object whose elements can be accessed one at a time during iteration. In simple terms, an iterable allows Python to move through its elements from beginning to end without requiring each element to be retrieved manually.
Whenever you use a for loop, Python automatically accesses the elements of an iterable one at a time until every element has been processed. This makes iterable objects suitable for loops and many other Python features that work with collections of data.
The following example shows how Python automatically processes each element of an iterable object.
Simple Example
fruits = ["Apple", "Banana", "Mango"]
for fruit in fruits:
print(fruit)
# Output
Apple
Banana
Mango
Here, fruits is the iterable object, and the for loop automatically processes each item in the list one after another until all elements have been visited.
Many of the objects you work with every day are iterable, including lists, tuples, strings, dictionaries, sets, and range() objects. However, not every Python object is iterable.
Objects such as integers, floating-point numbers, and Boolean values represent a single value rather than a collection of values, so they cannot be iterated over directly.
How an Iterable Works
Although a for loop appears simple, Python performs several steps behind the scenes. It first creates an iterator from the iterable and then repeatedly retrieves one element at a time until no elements remain.
Iterable
│
▼
iter()
│
▼
Iterator
│
▼
next()
│
▼
Next Element
Don’t worry if these steps seem unfamiliar. The upcoming tutorials explain how iter(), next(), and iterator objects work together to make iteration possible.
Remember: An iterable provides a collection of elements, while an iterator retrieves those elements one at a time during iteration.
Why Are Iterable Objects Important?
Without iterable objects, Python would not be able to process collections of data efficiently. Every time you loop through a list, read characters from a string, process lines in a file, or work with many built-in Python functions, you are using an iterable object.
Understanding iterable objects makes it much easier to learn iterators, generators, comprehensions, and many other advanced Python concepts.
Why Every Python Programmer Should Understand Iterables
- They are the starting point of every iteration process.
- They work seamlessly with
forloops. - They allow Python to process one element at a time.
- Many built-in data types are iterable.
- They form the foundation for understanding iterators and generators.
- Many built-in Python functions, such as
sum(),max(), andsorted(), accept iterable objects as input.
Example
message = "Python"
for letter in message:
print(letter)
# Output
P
y
t
h
o
n
Here, the string "Python" is an iterable object. Python automatically retrieves one character at a time and prints it until the string has been completely processed.
Characteristics of Python Iterables
Although iterable objects come in different forms, they all share a few common characteristics that make iteration possible. Understanding these characteristics will help you recognize iterable objects and understand how Python processes them.
The following are some important characteristics of Python iterable objects:
- Provide Multiple Values
- Elements Are Processed One at a Time
- Can Create an Iterator
- Work Naturally with
forLoops - Supported by Many Built-in Functions
Let’s look at each of these characteristics in more detail.
1. Provide Multiple Values
Most iterable objects represent multiple values that can be accessed one after another. For example, a list stores several items, a string contains multiple characters, and a dictionary stores multiple key-value pairs.
colors = ["Red", "Green", "Blue"]Since the list contains multiple elements, Python can iterate through them one at a time.
2. Elements Are Processed One at a Time
During iteration, Python does not process all elements simultaneously. Instead, it processes each element individually before moving to the next until every element has been handled.
numbers = [10, 20, 30]
for number in numbers:
print(number)
# Output
10
20
30
This step-by-step processing makes iteration efficient and easy to understand.
3. Can Create an Iterator
Every iterable object can produce an iterator. Python creates this iterator by calling the iter() function, either automatically or manually.
numbers = [1, 2, 3]
iterator = iter(numbers)
The iterator returned by iter() is responsible for supplying successive elements during iteration.
You will learn more about the iter() function and iterator objects in the upcoming tutorials.
4. Work Naturally with for Loops
One of the biggest advantages of iterable objects is that they work directly with Python’s for loop. You simply provide the iterable, and Python automatically handles the iteration process.
fruits = ["Apple", "Banana", "Mango"]
for fruit in fruits:
print(fruit)
There is no need to manually retrieve each element because the for loop performs these steps internally.
5. Supported by Many Built-in Functions
Many built-in Python functions accept iterable objects as input. These functions automatically process the elements contained in the iterable.
numbers = [15, 30, 45]
print(sum(numbers))
print(max(numbers))
# Output
90
45
Functions such as sum(), min(), max(), sorted(), list(), and tuple() all work with iterable objects.
Remember: Although many collections are iterable, the two terms are not identical. An iterable is simply any object that can provide its elements one at a time during iteration. For example, a range() object is iterable even though it generates values as needed instead of storing all of them at once.
How Python Iteration Begins with Iterables
Every iteration in Python begins with an iterable object. Whether you use a for loop, call the iter() function yourself, or use many built-in functions, Python first creates an iterator from the iterable and then retrieves its elements one by one.
This sequence remains the same throughout Python. An iterable is converted into an iterator, and each call to next() retrieves the next available element until no elements remain.
Iterable
│
▼
iter()
│
▼
Iterator
│
▼
next()
│
▼
Next Element
Although this process happens automatically when using a for loop, understanding these steps makes it much easier to learn how iteration works internally.
Example
numbers = [100, 200, 300]
for number in numbers:
print(number)
In this example, numbers is an iterable object. Behind the scenes, Python creates an iterator from the list and repeatedly retrieves one element at a time until the iteration is complete.
Built-in Iterable Objects in Python
Python provides several built-in iterable objects that allow their elements to be processed during iteration. Although they differ in how they store and organize data, they all support iteration and work naturally with for loops and many built-in Python functions.
The following are the most commonly used built-in iterable objects in Python.
- Lists – Ordered, mutable collections that can store multiple values.
- Tuples – Ordered collections whose elements cannot be modified after creation.
- Strings – Sequences of characters that can be processed one character at a time.
- Dictionaries – Collections of key-value pairs that support iteration over keys, values, or both.
- Sets – Unordered collections of unique elements.
- range() – Generates a sequence of numbers without storing them all in memory.
- File Objects – Objects returned by the
open()function that support iteration while reading file contents. - Bytes & Bytearrays – Store binary data that can be processed one byte at a time.
How to Check Whether an Object Is Iterable
Now that you’ve seen the most common iterable objects, the next step is learning how to determine whether a Python object is actually iterable.
Python provides several ways to determine whether an object is iterable. Two of the most common approaches are:
Let’s look at both approaches:
1. Using iter()
The iter() function creates an iterator from an iterable object. If the object is not iterable, Python raises a TypeError. Because of this behavior, iter() can also be used to determine whether an object is iterable.
Example: Iterable Object
numbers = [10, 20, 30]
iterator = iter(numbers)
Since iter() successfully creates an iterator, numbers is an iterable object. The iterator can then be used to retrieve the elements during iteration. You’ll learn how that works in the upcoming tutorial on Python iterators.
Example: Non-Iterable Object
number = 10
iter(number)
# Raises
TypeError: 'int' object is not iterable
An integer represents a single value rather than a collection of values. Since Python cannot create an iterator from it, calling iter() raises a TypeError.
2. Using isinstance() with Iterable
Another way to check whether an object is iterable is to use the isinstance() function together with Iterable from the collections.abc module.
Unlike iter(), isinstance() checks whether an object is iterable without creating an iterator or raising an exception.
from collections.abc import Iterable
numbers = [10, 20, 30]
print(isinstance(numbers, Iterable))
# Output
True
If the object is iterable, isinstance() returns True. Otherwise, it returns False.
Common Iterable and Non-Iterable Objects
Python includes many built-in iterable objects. The table below shows some common examples, whether they are iterable, and a brief explanation.
| Object | Iterable? | Explanation |
|---|---|---|
| List | Yes | Stores multiple items that can be processed one by one. |
| Tuple | Yes | Contains an ordered sequence of values. |
| String | Yes | Allows Python to process one character at a time. |
| Dictionary | Yes | Returns its keys by default during iteration. |
| Set | Yes | Provides each unique element during iteration. |
range() |
Yes | Generates values one at a time as needed. |
| File Object | Yes | Provides one line at a time while reading a file. |
| Integer | No | Represents a single value rather than a collection. |
| Float | No | Represents a single numeric value. |
| Boolean | No | Represents a single logical value. |
As you can see, iterable objects either store multiple values or generate them one after another, allowing Python to process each value during iteration.
Example
data = ("Python", "Java", "C++")
for language in data:
print(language)
# Output
Python
Java
C++
In this example, the tuple is iterable, so the for loop automatically processes each element until all values have been visited.
Common Beginner Mistakes: Iterable Objects
When learning about Python iterable objects, beginners often confuse iterables with iterators or assume that every Python object can be used in a for loop. Understanding these common mistakes will help you avoid unnecessary errors.
The following are some of the most common mistakes beginners make when working with iterable objects.
- Assuming Every Python Object Is Iterable
- Confusing Iterables with Iterators
- Forgetting That Dictionaries Iterate Over Keys by Default
- Assuming Every Iterable Stores Its Values
Let’s look at each of these mistakes and understand how to avoid them.
1. Assuming Every Python Object Is Iterable
Not every Python object is iterable. Objects such as integers, floating-point numbers, and Boolean values represent a single value, so they cannot be processed using a for loop.
number = 100
for value in number:
print(value)
This code raises a TypeError because an integer is not an iterable object.
2. Confusing Iterables with Iterators
An iterable and an iterator are closely related, but they are not the same. An iterable can produce an iterator, while an iterator retrieves the elements during iteration.
This distinction becomes much clearer when you begin learning about Python iterators in the next tutorial.
3. Forgetting That Dictionaries Iterate Over Keys by Default
Many beginners expect a dictionary to return both keys and values automatically. However, when you iterate over a dictionary directly, Python returns only its keys.
student = {
"name": "John",
"age": 20
}
for item in student:
print(item)
# Output
name
age
To iterate over keys and values together, use the items() method.
4. Assuming Every Iterable Stores Its Values
Some iterable objects, such as range(), generate values only when they are needed instead of storing all values in memory. This makes them memory efficient even for large sequences.
Key Takeaways: Python Iterables
Here’s a quick summary of what you’ve learned in this tutorial:
- Python iterable objects are the starting point of every iteration.
- An iterable allows Python to access its elements one by one.
- Lists, tuples, strings, dictionaries, sets, files, bytes, bytearrays, and
range()objects are common built-in iterables. - You can check whether an object is iterable by using
iter()orisinstance()withIterable. - Not every Python object is iterable. Objects such as integers, floats, and Boolean values are not iterable.
- An iterable is different from an iterator. An iterable creates an iterator, while an iterator retrieves the elements during iteration.