Python function Return Multiple Values [SOLVED]


Python

Whether you're a seasoned developer or just getting started with Python, understanding how to effectively use functions is crucial for writing clean, reusable, and efficient code. One common question that arises is: how do you go about returning multiple values from a function? In Python, there are several idiomatic ways to achieve this, allowing you to choose the method that best suits your specific use case. This article aims to be your comprehensive guide on how to make your functions in Python return multiple values. We'll cover various approaches, ranging from using basic data structures like tuples and lists to more advanced methods like dictionaries and custom objects.

By the end of this article, you'll be well-equipped to tackle any scenario that requires you to return multiple values from functions in Python.

So let's dive in and explore the different ways you can leverage Python's flexibility in returning multiple values from functions.

 

Basics of Function Return Values

Before delving into how to return multiple values in Python, it's essential to understand the basics of function return values. Functions in Python are blocks of reusable code that perform specific tasks and may return a value using the return keyword.

 

Single Return Value in Python

In Python, a function can return a single value, which could be a simple type like an integer, float, or string, or a more complex type like a list, tuple, or dictionary. The value is returned using the return keyword inside the function.

The basic syntax of a function returning a single value is as follows:

def function_name(arguments):
    # function body
    return value_to_return

Here is a simple example of a function that takes two numbers as arguments and returns their sum.

def add(a, b):
    sum_value = a + b
    return sum_value

result = add(5, 3)
print("The sum is:", result)  # Output: The sum is: 8

In this example, the add function calculates the sum of a and b and returns the result using the return keyword. The returned value is then stored in the variable result.

 

Multiple Return Values in Python

Python allows you to return multiple values by separating return values with commas. When multiple values are returned this way, they are actually packed into a single tuple, which is then unpacked by the calling function to capture the individual values.

The basic syntax for returning multiple values from a function is:

def function_name(arguments):
    # function body
    return value1, value2, ..., valueN

When calling this function, you can capture the returned values like so:

val1, val2, ..., valN = function_name(arguments)

Here is a simple example of a function that takes a list of numbers and returns the sum, average, and maximum value of the list.

def compute_stats(numbers):
    sum_value = sum(numbers)
    average_value = sum_value / len(numbers)
    max_value = max(numbers)
    return sum_value, average_value, max_value

# Calling the function
sum_val, avg_val, max_val = compute_stats([1, 2, 3, 4, 5])

print(f"Sum: {sum_val}, Average: {avg_val}, Max: {max_val}")
# Output: Sum: 15, Average: 3.0, Max: 5

In this example, the compute_stats function performs three different calculations on a list of numbers and returns all three results. The function returns a tuple (sum_value, average_value, max_value), which is then unpacked into three separate variables sum_val, avg_val, and max_val.

 

Using Tuples to Return Multiple Values

Tuples are one of Python's built-in data types that can be used to store an ordered collection of items. They are often used for packing multiple values into a single variable, making them particularly useful for returning multiple values from functions.

In Python, a tuple is a collection of objects that are ordered and immutable. Unlike lists, tuples cannot be modified once created. They are defined by enclosing the elements in parentheses (), separated by commas. Tuples can hold items of any data type, and they maintain the order in which items were added.

The syntax for defining a tuple is:

my_tuple = (item1, item2, ..., itemN)

When using tuples to return multiple values from a function, the syntax is almost the same as returning a single value, but with multiple items separated by commas:

def function_name(arguments):
    # function body
    return item1, item2, ..., itemN

Here's an example that demonstrates how to use tuples to return multiple values from a function. In this example, we'll create a function that takes the dimensions of a rectangle and returns both the area and the perimeter.

def rectangle_stats(length, width):
    area = length * width
    perimeter = 2 * (length + width)
    return area, perimeter  # This effectively returns a tuple (area, perimeter)

# Calling the function
area, perimeter = rectangle_stats(5, 3)

print(f"Area: {area}, Perimeter: {perimeter}")
# Output: Area: 15, Perimeter: 16

In this example, the rectangle_stats function calculates the area and perimeter of a rectangle based on its length and width. The function then returns both values as a tuple (area, perimeter). When we call this function, we can unpack the returned tuple into two separate variables, area and perimeter.

 

Using Lists to Return Multiple Values

Lists are another built-in data type in Python that can be used to store an ordered collection of items. Unlike tuples, lists are mutable, meaning you can modify their contents. This flexibility makes lists another suitable choice for returning multiple values from functions.

In Python, a list is an ordered collection of items that can be of mixed types. Lists are defined by enclosing the elements in square brackets [], separated by commas. You can add, remove, or modify items in a list after it has been created.

The syntax for defining a list is:

my_list = [item1, item2, ..., itemN]

When using lists to return multiple values from a function, you simply place the values you want to return inside a list and use the return keyword:

def function_name(arguments):
    # function body
    return [item1, item2, ..., itemN]

Here's an example that demonstrates how to use lists to return multiple values from a function. We'll create a function that takes a list of numbers as an argument and returns the minimum, maximum, and average values in a list.

def calculate_stats(numbers):
    min_value = min(numbers)
    max_value = max(numbers)
    average_value = sum(numbers) / len(numbers)
    return [min_value, max_value, average_value]

# Calling the function
stats = calculate_stats([1, 2, 3, 4, 5])

print(f"Minimum: {stats[0]}, Maximum: {stats[1]}, Average: {stats[2]}")
# Output: Minimum: 1, Maximum: 5, Average: 3.0

In this example, the calculate_stats function performs three different calculations on the list of numbers and returns all three values in a list. When calling this function, the returned list is stored in the variable stats, and we can access individual statistics using index notation (stats[0], stats[1], stats[2]).

 

Using Dictionaries to Return Multiple Values

Dictionaries are yet another built-in data type in Python that can be used for returning multiple values from a function. They offer the advantage of returning named values, which can make your code more readable and self-explanatory.

In Python, a dictionary is an unordered collection of key-value pairs. Dictionaries are defined by enclosing the elements within curly braces {}, and each key-value pair is separated by a colon :. Keys must be unique and immutable, while values can be of any data type and can be modified.

The syntax for defining a dictionary is:

my_dict = {'key1': value1, 'key2': value2, ..., 'keyN': valueN}

When using dictionaries to return multiple values from a function, you create a dictionary with the values you want to return and then use the return keyword:

def function_name(arguments):
    # function body
    return {'key1': value1, 'key2': value2, ..., 'keyN': valueN}

Here's an example that illustrates how to use dictionaries to return multiple values from a function. In this example, we'll create a function that calculates the area and perimeter of a circle given its radius and returns these values in a dictionary.

import math

def circle_stats(radius):
    area = math.pi * math.pow(radius, 2)
    circumference = 2 * math.pi * radius
    return {'Area': area, 'Circumference': circumference}

# Calling the function
stats = circle_stats(5)

print(f"Area: {stats['Area']}, Circumference: {stats['Circumference']}")
# Output: Area: 78.53981633974483, Circumference: 31.41592653589793

In this example, the circle_stats function calculates the area and circumference of a circle based on its radius. It then returns these values in a dictionary with keys 'Area' and 'Circumference'. The returned dictionary is stored in the variable stats, and we can access the individual statistics using the keys.

 

Using Custom Objects to Return Multiple Values

In situations where you want to bundle related data and functionality together, Python's custom objects can be a powerful way to return multiple values from a function. Using custom objects, you can provide additional methods that operate on the returned data, making your code more organized and object-oriented.

Classes in Python are the cornerstone of object-oriented programming. They allow you to define the blueprint for creating objects that can hold both data and functions to manipulate that data. Once you define a class, you can create instances of the class, each with its own set of attributes and methods.

The basic syntax for defining a class in Python is:

class ClassName:
    def __init__(self, attribute1, attribute2, ..., attributeN):
        self.attribute1 = attribute1
        self.attribute2 = attribute2
        # ...
        self.attributeN = attributeN

    # Additional methods can be defined here

To return a custom object from a function, you would create an instance of the class with the necessary attributes and then return it:

def function_name(arguments):
    # function body
    return ClassName(value1, value2, ..., valueN)

Let's create a simple example where we have a function that calculates both the area and the perimeter of a rectangle. These values will be returned as an instance of a custom class called RectangleStats.

class RectangleStats:
    def __init__(self, area, perimeter):
        self.area = area
        self.perimeter = perimeter

    def display(self):
        print(f"Area: {self.area}, Perimeter: {self.perimeter}")

def calculate_rectangle_stats(length, width):
    area = length * width
    perimeter = 2 * (length + width)
    return RectangleStats(area, perimeter)

# Calling the function
rectangle = calculate_rectangle_stats(5, 3)

# Accessing the attributes
print(f"Area: {rectangle.area}, Perimeter: {rectangle.perimeter}")
# Output: Area: 15, Perimeter: 16

# Using a method of the custom object
rectangle.display()
# Output: Area: 15, Perimeter: 16

In this example, the RectangleStats class is designed to hold both the area and the perimeter of a rectangle. The calculate_rectangle_stats function performs the calculations and returns an instance of RectangleStats containing the computed values. Once returned, you can access the values directly using dot notation (rectangle.area and rectangle.perimeter) or you can call any methods that the custom object may contain (e.g., rectangle.display()).

 

Using Namedtuple for Readable Code

If you're looking for a more readable yet lightweight approach for returning multiple values from a function, Python's namedtuple from the collections module can be a great option. namedtuple provides all the functionalities of tuples but with the added benefit of being able to access the elements using named attributes.

Python’s namedtuple is part of the collections module and is essentially an extension of the built-in tuple data type. The primary advantage of namedtuple over regular tuples is that you can give names to each position in the tuple, making the code self-explanatory and more readable.

To use a namedtuple, you first need to define its structure by specifying its name and the names of its fields. The syntax is as follows:

from collections import namedtuple

MyNamedTuple = namedtuple('MyNamedTuple', ['field1', 'field2', ..., 'fieldN'])

Once the namedtuple is defined, you can create instances of it and return them from functions just like any other object:

def function_name(arguments):
    # function body
    return MyNamedTuple(value1, value2, ..., valueN)

Here's an example where we calculate the area and perimeter of a rectangle and return these values using a namedtuple:

from collections import namedtuple

# Define the namedtuple structure
RectangleStats = namedtuple('RectangleStats', ['area', 'perimeter'])

def calculate_rectangle_stats(length, width):
    area = length * width
    perimeter = 2 * (length + width)
    return RectangleStats(area, perimeter)

# Calling the function
rectangle = calculate_rectangle_stats(5, 3)

# Accessing the attributes
print(f"Area: {rectangle.area}, Perimeter: {rectangle.perimeter}")
# Output: Area: 15, Perimeter: 16

In this example, we define a namedtuple named RectangleStats with two fields: area and perimeter. The function calculate_rectangle_stats performs the calculations and returns an instance of RectangleStats containing these values. Once returned, you can access these values using dot notation, similar to how you would access attributes of a custom object.

 

Skipping Unneeded Return Values using Underscore (_) Placeholder

Returning multiple values from functions is a widely used practice in Python. However, you may encounter situations where you don't need all the values that a function returns. While you could capture those unwanted values in variables and simply not use them, Python offers a cleaner, more efficient way to ignore them. This chapter will delve into the specifics of how you can skip unneeded return values and the best practices around it.

The underscore (_) serves as a "throwaway" variable in Python, signifying that you're intentionally ignoring a particular value.

The underscore allows you to unpack values you don't need from functions returning multiple values. Let's look at the syntax with a simple example:

def my_function():
    return 1, 2, 3, 4

# Skipping the first value
_, b, c, d = my_function()

In this snippet, b, c, and d capture the values 2, 3, and 4 while the first value 1 is ignored.

Skipping Multiple Values: You can use multiple underscores if you need to skip more than one value:

# Skipping the first and last values
_, b, c, _ = my_function()

Skipping Intermediate Values: Skipping values in between is also straightforward:

# Skipping the third value
a, b, _, d = my_function()

 

Performance Considerations

When it comes to returning multiple values from a function, Python offers several options, each with its own performance characteristics. Depending on the specific requirements of your application, you may opt for one method over another for better performance or readability.

We can use Python's built-in timeit module to measure the performance of different methods for returning multiple values from a function.

 

Example: Comparing Tuple, List, Dictionary, Custom Object, and Namedtuple

Here's a simple example that compares the time taken by each method to return two values:

from collections import namedtuple
import timeit

# Using Tuple
def using_tuple(a, b):
    return a, b

# Using List
def using_list(a, b):
    return [a, b]

# Using Dictionary
def using_dict(a, b):
    return {'a': a, 'b': b}

# Using Custom Object
class CustomObj:
    def __init__(self, a, b):
        self.a = a
        self.b = b
def using_custom_obj(a, b):
    return CustomObj(a, b)

# Using Namedtuple
Pair = namedtuple('Pair', ['a', 'b'])
def using_namedtuple(a, b):
    return Pair(a, b)

# Time each method using timeit
tuple_time = timeit.timeit("using_tuple(1, 2)", setup="from __main__ import using_tuple", number=1000000)
list_time = timeit.timeit("using_list(1, 2)", setup="from __main__ import using_list", number=1000000)
dict_time = timeit.timeit("using_dict(1, 2)", setup="from __main__ import using_dict", number=1000000)
custom_obj_time = timeit.timeit("using_custom_obj(1, 2)", setup="from __main__ import using_custom_obj", number=1000000)
namedtuple_time = timeit.timeit("using_namedtuple(1, 2)", setup="from __main__ import using_namedtuple", number=1000000)

print(f"Tuple: {tuple_time}")
print(f"List: {list_time}")
print(f"Dictionary: {dict_time}")
print(f"Custom Object: {custom_obj_time}")
print(f"Namedtuple: {namedtuple_time}")

This would output the time taken by each method in seconds. Generally, you'll find that tuples and lists are the fastest, followed by namedtuples, dictionaries, and custom objects, in that order.

Tuple: 0.057374636991880834
List: 0.08229691709857434
Dictionary: 0.19255208305548877
Custom Object: 0.23691045108716935
Namedtuple: 0.32367026794236153

Observations

  1. Tuple: The fastest method, making it suitable for scenarios where speed is crucial, and you don't require named fields.
  2. List: Slightly slower than tuples but offers mutability. Good for instances where the values may need to change.
  3. Dictionary: Slower than both tuples and lists but offers the advantage of named fields for better readability and self-documenting code.
  4. Custom Object: Even slower, primarily due to the overhead of object creation. Use it for complex use-cases where you need methods alongside data.
  5. Namedtuple: The slowest among the tested methods. While they offer the benefit of named fields like dictionaries and are immutable like tuples, they do so at a performance cost.

 

When to Use Which Method for Optimal Performance

  • For Maximum Speed: Use tuples when you don't need to alter the returned values and don't require named fields.
  • For Mutability: Use lists if you need the ability to change the values after they are returned.
  • For Readability: Use dictionaries or namedtuples when named fields would make your code more understandable.
  • For Complex Use-Cases: Use custom objects when you need to return a complex data structure complete with methods for manipulating the data.

 

Common Mistakes and How to Avoid Them

Returning multiple values from functions is a powerful feature in Python, but it can lead to several common mistakes, especially for those new to the language. Here's a roundup of some of these pitfalls and how to avoid them:

 

Unpacking Errors

Mistake: Trying to unpack more or fewer variables than the function returns can lead to a ValueError.

def return_values():
    return 1, 2

a, b, c = return_values()  # Raises ValueError: not enough values to unpack

How to Avoid: Ensure that the number of variables on the left-hand side matches the number of values returned by the function.

a, b = return_values()  # Correct

 

Ignoring Returned Values

Mistake: Ignoring one of the multiple values returned, which might lead to bugs in future code modifications.

a, _ = function_that_returns_important_values()

How to Avoid: If the function's values are essential, make sure to capture them properly in variables or at least document why you are ignoring specific values.

 

Mutability Errors with Lists

Mistake: Returning a mutable data structure like a list and then modifying it later in the code, which may inadvertently affect the original list returned by the function.

def return_list():
    return [1, 2, 3]

a = return_list()
a.append(4)  # This will modify the original list returned

How to Avoid: If the data should remain constant, consider returning an immutable data structure like a tuple instead of a list.

 

Overloading Functions

Mistake: Returning different types of data structures based on some condition within the function. This can make it hard to handle the function's output effectively.

def confusing_function(flag):
    if flag:
        return 1, 2
    else:
        return [1, 2]

How to Avoid: Stick to a single data structure for returning multiple values to make it easier for the caller to handle the function's output.

 

Summary

In Python, the ability to return multiple values from a function offers a versatile and convenient way to organize code and data. With the use of data structures like tuples, lists, dictionaries, and custom objects, Python allows you the flexibility to return as many values as needed. While tuples are the most efficient in terms of performance, dictionaries and namedtuples offer the benefit of named fields for better code readability. Custom objects serve well when complex data types with behaviors (methods) are required.

However, this flexibility comes with its own set of challenges. Common pitfalls include unpacking errors, ignoring essential values, and choosing inappropriate data structures. The underscore (_) serves as a useful tool for discarding values that you don't need, helping both with code cleanliness and possibly minor performance improvements. As a best practice, always align your choice of the returning structure with the specific needs of the task and ensure that you document or handle any ignored values appropriately.

 

Additional Resources

  1. Python Functions: Basics and advanced features of defining functions. Python 3.9 Functions
  2. Python Data Structures: Comprehensive guide on lists, tuples, and dictionaries. Python 3.9 Data Structures
  3. Built-in Types: In-depth details about Python's built-in types like tuples and lists. Python 3.9 Built-in Types
  4. Python Glossary - Tuple: Quick rundown on tuples. Python 3.9 Glossary
  5. collections.namedtuple: Make code readable with namedtuples. collections.namedtuple

 

 

Deepak Prasad

Deepak Prasad

Deepak Prasad is the founder of GoLinuxCloud, bringing over a decade of expertise in Linux, Python, Go, Laravel, DevOps, Kubernetes, Git, Shell scripting, OpenShift, Networking, and Security. His extensive experience spans development, DevOps, networking, and security, ensuring robust and efficient solutions for diverse projects.

Certifications and Credentials:

  • Certified Kubernetes Application Developer (CKAD)
  • Go Developer Certification
  • Linux Foundation Certified System Administrator (LFCS)
  • Certified Ethical Hacker (CEH)
  • Python Institute PCAP (Certified Associate in Python Programming)
You can connect with him on his LinkedIn profile and join his Facebook and LinkedIn page.

Can't find what you're searching for? Let us assist you.

Enter your query below, and we'll provide instant results tailored to your needs.

If my articles on GoLinuxCloud has helped you, kindly consider buying me a coffee as a token of appreciation.

Buy GoLinuxCloud a Coffee

For any other feedbacks or questions you can send mail to admin@golinuxcloud.com

Thank You for your support!!

Leave a Comment