Python Tuple tuple() Method

---

---

The Python Tuple tuple() method is used to convert a list of items into tuples.

A tuple is a collection of python objects that are separated by commas which are ordered and immutable. Tuples are sequences, just like lists. The difference between tuples and lists are: tuples cannot be changed unlike lists and tuples use parentheses, whereas lists use square brackets.

Syntax

Following is the syntax of Python Tuple tuple() method −

tuple(seq)

Parameters

• seq − This is a sequence to be converted into tuple.

Return Value

This method returns this tuple.

Example

The following example shows the usage of Python Tuple tuple() method. Here a list 'aList' is creating which consists of strings as its elements. Then this list is converted into tuple using tuple() method.

aList = ['xyz', 'zara', 'abc']
aTuple = tuple(aList)
print ("Tuple elements : ", aTuple)

When we run above program, it produces following result −

Tuple elements :  ('xyz', 'zara', 'abc')

Example

In here, we are creating a dictionary 'dict1'. Then this dictionary is passed as an argument to the tuple() method. Thereafter, we retrieve the tuple of the dictionary.

# iterable dictionary
dict1 = {'Name': 'Rahul', 'Hobby': 'Singing', 'RollNo': 45}
# using tuple() method
res = tuple(dict1)
# printing the result
print("dictionary to tuple:", res)

While executing the above code we get the following output −

dictionary to tuple: ('Name', 'Hobby', 'RollNo')

Example

Now, we will create a string. Then this string is passed as an argument to the tuple() method. Thereafter, we retrieve the tuple of the string.

# iterable string
string = "Tutorials Point";
# using tuple() method
res = tuple(string)
# printing the result
print("converted string to tuple:", res)

Following is an output of the above code −

converted string to tuple: ('T', 'u', 't', 'o', 'r', 'i', 'a', 'l', 's', ' ', 'P', 'o', 'i', 'n', 't')

Example

The tuple() method does not raise any error if an empty tuple is passed in this method. It returns an empty tuple.

# empty tuple
tup = tuple()
print("Output:", tup)

Output of the above code is as follows −

empty tuple: ()

Example

The tuple() method raises a TypeError, if an iterable is not passed. The code given below explains it.

#a non-iterable is passed as an argument
tup = tuple(87)
# printing the result
print('Output:', tup)

We get the output of the above code as shown below −

Traceback (most recent call last):
  File "C:\Users\Lenovo\Desktop\untitled.py", line 2, in <module>
    tup = tuple(87)
TypeError: 'int' object is not iterable