How to Return Multiple Values from a Function in Python

5/5 - (1 vote)

Understanding Functions in Python

💡 A Python function is a block of reusable code that performs a specific task. Functions help break your code into smaller, more modular and manageable pieces, which improves readability and maintainability. Python functions are defined using the def keyword, followed by the function’s name and a pair of parentheses containing any input arguments.

A simple example of a Python function:

def greet(name):
    return f"Hello, {name}!"

Here, the greet function takes a single argument, name, and returns a string containing a greeting message. You can call a function by using its name followed by the arguments in parentheses. The caller is responsible for passing the correct number and type of arguments as required by the function.

To call the greet function, you would write:

message = greet("Alice")
# Output: Hello, Alice!

The execution of a function starts at the first line inside the function block and proceeds line by line until it encounters a return statement or reaches the end of the function.

The return statement is used to return a value to the caller. If a function doesn’t have a return statement or it doesn’t execute during the function execution, the function will implicitly return None.

In Python, functions can also accept default argument values:

def greet(name, greeting="Hello"):
    return f"{greeting}, {name}!"

Now, the greet function has an additional argument greeting with a default value of "Hello". When calling this function, if the greeting argument is not provided, the default value will be used:

message = greet("Alice")  # Uses default greeting
print(message)  # Output: Hello, Alice!

message = greet("Alice", "Hi")  # Custom greeting
print(message)  # Output: Hi, Alice!

Before we move on to other important variations of this problem of returning multiple values from a function (and make you a better coder in the process), feel free to check out our fun guide on making $ with Python:

💡 Recommended: 21 Most Profitable Programming Languages

Basic Return Statement

In Python, the return statement allows a function to send data back to the caller. This data is known as the function’s return value. The return statement is a fundamental concept when creating custom functions in Python.

Let’s explore some examples of how it works. A simple function with a return statement might look like this:

def sum_two_numbers(a, b):
    total = a + b
    return total

result = sum_two_numbers(3, 5)
print(result)  # Output: 8

In this example, the return statement sends the sum of two numbers back to the caller, and the result is stored in the variable result. The return statement can also return multiple values by using a tuple, list, or dictionary.

Here’s an example returning multiple values using a tuple:

def sum_and_difference(a, b):
    return a + b, a - b

addition, subtraction = sum_and_difference(10, 5)
print(addition)  # Output: 15
print(subtraction)  # Output: 5

This function sums and subtracts two numbers and returns the result as a tuple. The return values are assigned to the variables addition and subtraction when the function is called.

In some cases, you might need to return more complex data structures or even objects. Here’s an example using a dictionary:

def basic_math_operations(a, b):
    return {
        "sum": a + b,
        "difference": a - b,
        "product": a * b,
        "division": a / b,

result = basic_math_operations(4, 2)
print(result["sum"])  # Output: 6
print(result["difference"])  # Output: 2
print(result["product"])  # Output: 8
print(result["division"])  # Output: 2.0

In this example, the function performs basic math operations and returns the results in a dictionary. The caller can then easily access the desired value by using the appropriate key.

Returning Multiple Values

In Python, it’s possible to return multiple values from a single function. This powerful feature sets Python apart from other programming languages where such a task might be tricky. There are several methods you can use to return multiple values in Python, including using tuples, lists, and dictionaries.

Tuples are the most common way to return multiple values from a function. You can implicitly or explicitly create a tuple, which is an ordered, immutable collection of values. To return multiple values using a tuple, simply separate the values with a comma.

See here: 👇

def divide(x, y):
    quotient = x // y
    remainder = x % y
    return quotient, remainder

q, r = divide(22, 7)

In this example, the divide function returns both the quotient and the remainder as a tuple, which can be unpacked into the variables q and r.

💡 Recommended: Python Return Tuple From Function

Another option to return multiple values is using lists. Lists are similar to tuples, but they are mutable and denoted by square brackets.

Here’s an example:

def foo(x):
    square = x * x
    cube = x ** 3
    return [square, cube]

squared, cubed = foo(3)

The foo function returns a list with the square and cube of the input value, and the list is unpacked into the variables squared and cubed.

💡 Recommended: Python Return List

Dictionaries can also be used to return multiple values, especially when each value has a specific label or key associated with it. Dictionaries are unordered, mutable collections of key-value pairs.

An example:

def bar(x):
    doubled = x * 2
    tripled = x * 3
    return {'double': doubled, 'triple': tripled}

result = bar(4)

In this example, the bar function returns a dictionary containing both the doubled and tripled values of the input number.

💡 How to Return a Dictionary From a Function?

Using Tuples to Return Values

The simplest and most commonly used methods to return multiple values from a Python function is by using tuples.

💡 Tuples are an ordered collection of elements enclosed in parentheses (). They are immutable, which means the elements cannot be changed after the tuple is created. You can use tuples containing elements of different data types, such as int, str, or any other type.

To return multiple values using tuples, you can separate the values by commas while using the return statement. You don’t even need to enclose the return statement in parentheses to create a tuple.

Take a look at the following example:

def calculate_numbers(x, y):
    sum_numbers = x + y
    difference = x - y
    product = x * y
    return sum_numbers, difference, product

result = calculate_numbers(3, 2)
print(result)  # Output: (5, 1, 6)

In the example above, the calculate_numbers function takes two arguments x and y, and returns three values as a tuple, which includes the sum, difference, and product of these two numbers.

After calling the function and assigning the returned values to a variable like result, you can access the individual values using indexing. For instance, result[0] would give you the first value returned (sum), result[1] second value (difference), and so on.

To make the code even more readable, you can use tuple unpacking to directly assign the returned values to separate variables. Here’s an example:

sum_result, difference_result, product_result = calculate_numbers(3, 2)
print(sum_result)        # Output: 5
print(difference_result) # Output: 1
print(product_result)    # Output: 6

In this case, the tuple returned by the calculate_numbers function is automatically unpacked, and the individual results are instantly assigned to the corresponding variables.

Returning Values with Lists

In Python, a convenient way of returning multiple values from a function is by using lists. Lists allow you to store and manipulate a collection of items, making them perfect for holding multiple outputs from your functions. You can return a list from a function by simply placing the desired elements inside square brackets and separating them with commas.

def example_function():
    return [item1, item2, item3]

Once you have your list returned by the function, you can easily access individual values using indexing. Remember that indexing in Python starts from 0, so if you want to access the first element of the list, you need to use the index 0:

result = example_function()
first_item = result[0]

Working with lists also allows you to take advantage of other Python features such as list comprehensions and slicing. For example, you can easily modify or filter the items in the returned list with a concise and easy-to-read syntax:

squared_result = [x**2 for x in result if x > 0]

In some cases, it might be better to return multiple lists instead of a single list with multiple values. This approach is especially useful if the data types of the returned values are different or if the returned values represent different entities or properties. You can achieve this by simply including multiple lists in the return statement:

def multiple_lists_function():
    return [1, 2, 3], ['apple', 'banana', 'cherry']

numbers, fruits = multiple_lists_function()

Functionally, returning lists is quite similar to using tuples, another common way of returning multiple values in Python. However, lists offer additional functionality like being mutable, which means they can be resized or modified after creation, unlike tuples.

👉 For a detailed example of how to return a list from a function, you can check out this Python Return List tutorial.

Returning Values in Dictionaries

In Python, dictionaries are a versatile data structure that can store multiple key-value pairs. To return multiple values from a function, you can use a dictionary by combining keys with their corresponding values. This enables you to create a concise and organized representation of the returned data.

One way to return multiple values in a dictionary is by directly creating a dictionary within the function. You can use the curly braces {} to define the dictionary and separate keys and values with a colon. Here’s an example:

def example_function():
    return {"key1": "value1", "key2": "value2"}

result = example_function()

The output will be:

{"key1": "value1", "key2": "value2"}

Another approach to return multiple values is by using the dict() constructor. This method allows you to create a dictionary by passing key-value pairs as arguments. An example is shown below:

def example_function():
    return dict(key1="value1", key2="value2")

result = example_function()

This will produce the same output as the previous example:

{"key1": "value1", "key2": "value2"}

Dictionaries can also store multiple values for a single key. One way to accomplish this is by storing values as lists within the dictionary. You can add multiple values to a key in a Python dictionary using different methods. The following example illustrates this technique:

def example_function():
    return {"key1": ["value1", "value2"], "key2": ["value3", "value4"]}

result = example_function()

The output will be:

{"key1": ["value1", "value2"], "key2": ["value3", "value4"]}

Python Named Tuples

Python named tuples are a convenient way to return multiple values from a function. They belong to the collections module and offer a combination of the benefits of both dictionaries and tuples. Named tuples are immutable, like tuples, and allow access to elements using attribute names as well as indices, making the code more readable.

To create a named tuple, you need to import the namedtuple function from the collections module. Then, you can define a new named tuple type by specifying its name and field names as arguments. Here’s an example:

from collections import namedtuple

Person = namedtuple("Person", ["name", "age", "city"])

Once you have a named tuple type, you can create instances and access their values using dot notation:

person = Person("Alice", 30, "NYC")

print(  # Output: Alice
print(person.age)   # Output: 30
print(  # Output: NYC

To return multiple values from a function using named tuples, simply define a named tuple type for the return values and return an instance of that type from the function. Here’s an example:

from collections import namedtuple

def get_name_age_city():
    return Person("Bob", 25, "Boston")

person_data = get_name_age_city()
print(  # Output: Bob
print(person_data.age)   # Output: 25
print(  # Output: Boston

In conclusion, using named tuples in Python simplifies the process of returning multiple values from a function and improves code readability. With namedtuple from the collections module, you can create custom data structures with named attributes, making it easy to access and manage the returned data.

Python Data Classes for Return Value

Python data classes provide an efficient way to bundle multiple values together when returning them from a function. A data class is a special type of class, primarily used to store data. It automatically generates special methods such as __init__, __repr__, and __eq__ for you, making it ideal for working with data objects.

To create a data class, first, you need to import the necessary module using the following statement:

from dataclasses import dataclass

Next, you can define a simple data class to represent the return value of a function. Let’s create a class named Result to store three values: value1, value2, and value3.

class Result:
    value1: int
    value2: int
    value3: int

Now that you have a data class, the next step is to create a function that returns an instance of this class. Let’s write a function named calculate_values that takes an integer input x, performs some calculations, and returns a Result object containing the computed values.

def calculate_values(x: int) -> Result:
    value1 = x * 2
    value2 = x + 3
    value3 = x ** 2
    return Result(value1, value2, value3)

To use the calculate_values function, call it with an argument and store the returned Result object in a variable. You can then access the multiple values returned using the attributes of the class:

result = calculate_values(10)
print(result.value1)  # Output: 20
print(result.value2)  # Output: 13
print(result.value3)  # Output: 100

Working with Generators

Generators in Python are a powerful way to handle large datasets or sequences without using up a lot of memory. They allow you to iterate through items one at a time using the yield keyword. A generator function is a special kind of function that returns a generator object when called.

Here’s a simple example of a generator function:

def count_up_to(max):
    count = 1
    while count <= max:
        yield count
        count += 1

In this example, the count_up_to function takes a single argument max and generates numbers from 1 up to the specified maximum value. The yield keyword is used to return the current value of count, and then the function continues to execute until the while loop is no longer True.

You can use a generator like this:

counter = count_up_to(5)
for number in counter:

This code will output:


To return multiple values from a generator function, you can simply yield them as tuples or lists. For example, let’s create a generator function that returns both the current number and its square:

def numbers_and_squares(max):
    num = 1
    while num <= max:
        yield num, num**2
        num += 1

Now, you can iterate through the multiple values like this:

for num, square in numbers_and_squares(5):
    print(f"{num}: {square}")

This will output:

1: 1
2: 4
3: 9
4: 16
5: 25

As you can see, using generators with the yield keyword allows you to efficiently return multiple values from a function in Python.

Advanced Return Techniques

In Python, you can return multiple values from a function using advanced techniques such as objects, tuples, and dictionaries. One of the common ways to return multiple values is to use an object. You can create a class to hold multiple values and return an instance of that class from the function.

Here’s an example:

class Result:
    def __init__(self, value1, value2):
        self.value1 = value1
        self.value2 = value2

def function():
    return Result(1, 2)

result = function()
print(result.value1, result.value2)

Another popular technique involves using tuples. In Python, it’s very simple to return multiple values in a single return statement by listing those values separated by commas. This creates a tuple, allowing you to extract elements from Python lists or tuples with ease.

def function():
    return 1, 2

value1, value2 = function()
print(value1, value2)

Dictionaries present another alternative for returning multiple values. This is especially useful if your return values have labels or identifiers. Just like converting a CSV file to a Python dictionary, you can structure your return values in key-value pairs and access them accordingly.

def function():
    return {'value1': 1, 'value2': 2}

result = function()
print(result['value1'], result['value2'])

Frequently Asked Questions

How can a Python function return multiple outputs?

A Python function can return multiple outputs by separating them with commas in the return statement. When you return multiple values, Python automatically packs them into a tuple. Here’s an example:

def multiple_outputs():
    x = 5
    y = 10
    z = 15
    return x, y, z

output = multiple_outputs()
print(output)  # Output: (5, 10, 15)

What is the role of tuples in returning multiple values from a function in Python?

Tuples play a crucial role in returning multiple values from a function in Python. When you return multiple values, Python automatically packs them into a tuple. You can also explicitly create a tuple and return it from the function. Unpacking the tuple allows you to access the individual values:

def multiple_values():
    a = 1
    b = 2
    c = 3
    return (a, b, c)

value1, value2, value3 = multiple_values()
print(value1, value2, value3)  # Output: 1 2 3

How can I use lists to return multiple values from a Python function?

You can use lists to return multiple values from a Python function by packing the values into a list and returning the list:

def return_list():
    item1 = "apple"
    item2 = "banana"
    return [item1, item2]

fruit_list = return_list()
print(fruit_list)  # Output: ['apple', 'banana']

In which ways can I use dictionaries for returning multiple items in a Python function?

You can use dictionaries to return multiple items in a Python function by creating a dictionary with key-value pairs and returning the dictionary:

def return_dict():
    user1 = "Alice"
    score1 = 95
    user2 = "Bob"
    score2 = 89
    return {"user1": user1, "score1": score1, "user2": user2, "score2": score2}

result = return_dict()
print(result)  # Output: {'user1': 'Alice', 'score1': 95, 'user2': 'Bob', 'score2': 89}

Can a Python function have multiple return statements?

Yes, a Python function can have multiple return statements. This can be useful when leveraging conditional statements to determine which value to return based on specific conditions:

def check_even(number):
    if number % 2 == 0:
        return True
        return False

print(check_even(4))  # Output: True
print(check_even(7))  # Output: False

What are the similarities and differences between returning values in Python compared to Java and JavaScript?

In Python, you can easily return multiple values by separating them with commas, and the function automatically packs the values into a tuple. In Java, to return multiple values, you typically use a class or an array. Java also requires specifying the return type. In JavaScript, you can return multiple values using an array or an object, similar to Python’s list and dictionary approach.

Python’s simplicity in returning multiple values stands out as a key difference and advantage compared to Java and JavaScript, which generally require additional data structures to achieve the same functionality.

💡 Recommended: 20 Real Python Projects to Make Money