what is Python Tuples?

 

Python Tuples

ytuple = ("apple""banana""cherry")

Tuple

Tuples are used to store multiple items in a single variable.

Tuple is one of 4 built-in data types in Python used to store collections of data, the other 3 are ListSet, and Dictionary, all with different qualities and usage.

A tuple is a collection which is ordered and unchangeable.

Tuples are written with round brackets.

ExampleGet your own Python Server

Create a Tuple:

thistuple = ("apple""banana""cherry")
print(thistuple)
Try it Yourself »

Tuple Items

Tuple items are ordered, unchangeable, and allow duplicate values.

Tuple items are indexed, the first item has index [0], the second item has index [1] etc.


Ordered

When we say that tuples are ordered, it means that the items have a defined order, and that order will not change.


Unchangeable

Tuples are unchangeable, meaning that we cannot change, add or remove items after the tuple has been created.


Allow Duplicates

Since tuples are indexed, they can have items with the same value:

Example

Tuples allow duplicate values:

thistuple = ("apple""banana""cherry""apple""cherry")
print(thistuple)
Try it Yourself »

ADVERTISEMENT

Tuple Length

To determine how many items a tuple has, use the len() function:

Example

Print the number of items in the tuple:

thistuple = ("apple""banana""cherry")
print(len(thistuple))
Try it Yourself »

Create Tuple With One Item

To create a tuple with only one item, you have to add a comma after the item, otherwise Python will not recognize it as a tuple.

Example

One item tuple, remember the comma:

thistuple = ("apple",)
print(type(thistuple))

#NOT a tuple
thistuple = ("apple")
print(type(thistuple))
Try it Yourself »

Tuple Items - Data Types

Tuple items can be of any data type:

Example

String, int and boolean data types:

tuple1 = ("apple""banana""cherry")
tuple2 = (15793)
tuple3 = (TrueFalseFalse)
Try it Yourself »

A tuple can contain different data types:

Example

A tuple with strings, integers and boolean values:

tuple1 = ("abc"34True40"male")
Try it Yourself »

type()

From Python's perspective, tuples are defined as objects with the data type 'tuple':

<class 'tuple'>

Example

What is the data type of a tuple?

mytuple = ("apple""banana""cherry")
print(type(mytuple))
Try it Yourself »

The tuple() Constructor

It is also possible to use the tuple() constructor to make a tuple.

Example

Using the tuple() method to make a tuple:

thistuple = tuple(("apple""banana""cherry")) # note the double round-brackets
print(thistuple)
Try it Yourself »

Python Collections (Arrays)

There are four collection data types in the Python programming language:

  • List is a collection which is ordered and changeable. Allows duplicate members.
  • Tuple is a collection which is ordered and unchangeable. Allows duplicate members.
  • Set is a collection which is unordered, unchangeable*, and unindexed. No duplicate members.
  • Dictionary is a collection which is ordered** and changeable. No duplicate members.

Python - Access Tuple Items


Access Tuple Items

You can access tuple items by referring to the index number, inside square brackets:

ExampleGet your own Python Server

Print the second item in the tuple:

thistuple = ("apple""banana""cherry")
print(thistuple[1])
Try it Yourself »

Note: The first item has index 0.


Negative Indexing

Negative indexing means start from the end.

-1 refers to the last item, -2 refers to the second last item etc.

Example

Print the last item of the tuple:

thistuple = ("apple""banana""cherry")
print(thistuple[-1])
Try it Yourself »

Range of Indexes

You can specify a range of indexes by specifying where to start and where to end the range.

When specifying a range, the return value will be a new tuple with the specified items.

Example

Return the third, fourth, and fifth item:

thistuple = ("apple""banana""cherry""orange""kiwi""melon""mango")
print(thistuple[2:5])
Try it Yourself »

Note: The search will start at index 2 (included) and end at index 5 (not included).

Remember that the first item has index 0.

By leaving out the start value, the range will start at the first item:

Example

This example returns the items from the beginning to, but NOT included, "kiwi":

thistuple = ("apple""banana""cherry""orange""kiwi""melon""mango")
print(thistuple[:4])
Try it Yourself »

By leaving out the end value, the range will go on to the end of the tuple:

Example

This example returns the items from "cherry" and to the end:

thistuple = ("apple""banana""cherry""orange""kiwi""melon""mango")
print(thistuple[2:])
Try it Yourself »


Range of Negative Indexes

Specify negative indexes if you want to start the search from the end of the tuple:

Example

This example returns the items from index -4 (included) to index -1 (excluded)

thistuple = ("apple""banana""cherry""orange""kiwi""melon""mango")
print(thistuple[-4:-1])
Try it Yourself »

Check if Item Exists

To determine if a specified item is present in a tuple use the in keyword:

Example

Check if "apple" is present in the tuple:

thistuple = ("apple""banana""cherry")
if "apple" in thistuple:
  print("Yes, 'apple' is in the fruits tuple")
Try it Yourself »

Python - Update Tuples


Tuples are unchangeable, meaning that you cannot change, add, or remove items once the tuple is created.

But there are some workarounds.


Change Tuple Values

Once a tuple is created, you cannot change its values. Tuples are unchangeable, or immutable as it also is called.

But there is a workaround. You can convert the tuple into a list, change the list, and convert the list back into a tuple.

ExampleGet your own Python Server

Convert the tuple into a list to be able to change it:

x = ("apple""banana""cherry")
y = list(x)
y[1] = "kiwi"
x = tuple(y)

print(x)
Try it Yourself »

Add Items

Since tuples are immutable, they do not have a built-in append() method, but there are other ways to add items to a tuple.

1. Convert into a list: Just like the workaround for changing a tuple, you can convert it into a list, add your item(s), and convert it back into a tuple.

Example

Convert the tuple into a list, add "orange", and convert it back into a tuple:

thistuple = ("apple""banana""cherry")
y = list(thistuple)
y.append("orange")
thistuple = tuple(y)
Try it Yourself »

2. Add tuple to a tuple. You are allowed to add tuples to tuples, so if you want to add one item, (or many), create a new tuple with the item(s), and add it to the existing tuple:

Example

Create a new tuple with the value "orange", and add that tuple:

thistuple = ("apple""banana""cherry")
y = ("orange",)
thistuple += y

print(thistuple)
Try it Yourself »

Note: When creating a tuple with only one item, remember to include a comma after the item, otherwise it will not be identified as a tuple.



Remove Items

Note: You cannot remove items in a tuple.

Tuples are unchangeable, so you cannot remove items from it, but you can use the same workaround as we used for changing and adding tuple items:

Example

Convert the tuple into a list, remove "apple", and convert it back into a tuple:

thistuple = ("apple""banana""cherry")
y = list(thistuple)
y.remove("apple")
thistuple = tuple(y)
Try it Yourself »

Or you can delete the tuple completely:

Example

The del keyword can delete the tuple completely:

thistuple = ("apple""banana""cherry")
del thistuple
print(thistuple) #this will raise an error because the tuple no longer exists
Try it Yourself »

Python - Unpack Tuples


Unpacking a Tuple

When we create a tuple, we normally assign values to it. This is called "packing" a tuple:

ExampleGet your own Python Server

Packing a tuple:

fruits = ("apple""banana""cherry")
Try it Yourself »

But, in Python, we are also allowed to extract the values back into variables. This is called "unpacking":

Example

Unpacking a tuple:

fruits = ("apple""banana""cherry")

(green, yellow, red) = fruits

print(green)
print(yellow)
print(red)
Try it Yourself »

Note: The number of variables must match the number of values in the tuple, if not, you must use an asterisk to collect the remaining values as a list.


ADVERTISEMENT

Using Asterisk*

If the number of variables is less than the number of values, you can add an * to the variable name and the values will be assigned to the variable as a list:

Example

Assign the rest of the values as a list called "red":

fruits = ("apple""banana""cherry""strawberry""raspberry")

(green, yellow, *red) = fruits

print(green)
print(yellow)
print(red)
Try it Yourself »

If the asterisk is added to another variable name than the last, Python will assign values to the variable until the number of values left matches the number of variables left.

Example

Add a list of values the "tropic" variable:

fruits = ("apple""mango""papaya""pineapple""cherry")

(green, *tropic, red) = fruits

print(green)
print(tropic)
print(red)
Try it Yourself »

Python - Loop Tuples


Loop Through a Tuple

You can loop through the tuple items by using a for loop.

ExampleGet your own Python Server

Iterate through the items and print the values:

thistuple = ("apple""banana""cherry")
for x in thistuple:
  print(x)
Try it Yourself »

Learn more about for loops in our Python For Loops Chapter.


Loop Through the Index Numbers

You can also loop through the tuple items by referring to their index number.

Use the range() and len() functions to create a suitable iterable.

Example

Print all items by referring to their index number:

thistuple = ("apple""banana""cherry")
for i in range(len(thistuple)):
  print(thistuple[i])
Try it Yourself »

ADVERTISEMENT

Using a While Loop

You can loop through the tuple items by using a while loop.

Use the len() function to determine the length of the tuple, then start at 0 and loop your way through the tuple items by referring to their indexes.

Remember to increase the index by 1 after each iteration.

Example

Print all items, using a while loop to go through all the index numbers:

thistuple = ("apple""banana""cherry")
i = 0
while i < len(thistuple):
  print(thistuple[i])
  i = i + 1
Try it Yourself »

Learn more about while loops in our Python While Loops Chapter.



*Set items are uncangeable, but you can remove and/or add items whenever you like.

Comments

Popular Posts