Return Values

Functions are not just for performing actions; they are often designed to compute a result and make that result available for further use. This is where return values become essential. A function's return value is the data it sends back to the part of the program that called it, allowing you to capture and utilize the outcome of its operations. Without return values, functions would be isolated operations, unable to contribute their computed results to the broader program flow.

The `return` Statement

The return statement is the explicit mechanism in Python for a function to send data back to its caller. When Python encounters a return statement, it immediately exits the function, passes the specified value (or values) back, and continues execution from the point where the function was called. This allows functions to act as computational units, producing outputs that can be assigned to variables, used in expressions, or passed to other functions.

pythonCalculating and Returning a Single Value

💡 Return Terminates Execution

A crucial aspect of return is that it immediately halts the function's execution. Any code written after a return statement within the same function will not be executed. This makes return a powerful control flow mechanism, allowing functions to exit early based on conditions.

Implicit `None` Returns

Not every function needs to explicitly return a value. Functions that perform actions, like printing to the console or modifying an object in place, might not have a return statement. In such cases, Python implicitly returns the special value None. None is a unique constant that signifies the absence of a value, similar to null in other programming languages. It's important to understand that even functions without an explicit return still technically return something.

pythonFunctions Without Explicit Returns Yield `None`

Check Your Understanding

What is the return value of a Python function that executes all its code but does not contain a return statement?

Returning Multiple Values

Python offers a convenient way to return multiple values from a single function. When you list several values after a return statement, Python automatically packs them into a tuple and returns that tuple. The caller can then either receive the tuple as a single object or immediately unpack its elements into separate variables. This feature is incredibly useful for functions that naturally produce several related pieces of information, like coordinates, statistics, or status codes.

pythonReturning and Unpacking Multiple Values

✨ Tuple Unpacking

When a function returns multiple values, you can unpack them into variables directly, like a, b, c = my_function(). The number of variables on the left side of the assignment must match the number of values in the returned tuple. If they don't match, Python will raise a ValueError.

Check Your Understanding

How does Python handle a return statement that lists multiple values, such as return x, y, z?

The Impact of `return` on Control Flow

The return statement is not just about sending data; it's also a control flow mechanism. As soon as Python executes a return statement, the function immediately terminates, and control is passed back to the caller. This means any code following the return statement within that function will be skipped. This behavior is often used to exit a function early if a certain condition is met, preventing unnecessary computations or handling error states.

pythonEarly Exit with `return`

Try It Yourself

Modify the process_data function to return (0, 'No data') instead of (None, 'Empty list') when an empty list is provided. Observe how the output changes.

python

Function Execution Flow with `return`

Loading diagram...

This diagram illustrates how a function executes. Upon encountering a `return` statement, the function immediately exits and passes its value back. If no `return` is explicitly met, the function completes and implicitly returns `None`.

Using Return Values in Expressions

A function's return value is not just for assignment to a variable; it can be used directly within other expressions, just like any other value. This allows for concise and readable code, where the result of one function immediately feeds into another operation or function call. Chaining function calls or embedding them within larger mathematical or logical expressions is a common pattern in Python programming.

pythonIntegrating Function Returns into Expressions

Key Takeaways

The return statement explicitly sends data back from a function to its caller.
Functions without an explicit return statement will implicitly return the special None value.
To return multiple values, list them comma-separated after return; Python automatically packs them into a tuple.
Multiple return values can be immediately unpacked into separate variables by the caller, like var1, var2 = my_func().
A return statement immediately terminates function execution, skipping any subsequent code within that function.
Function return values can be used directly in expressions, nested function calls, or assigned to variables for later use.

← All lessons in Functions & Scope

Return Values

The return Statement

Implicit None Returns

Returning Multiple Values

The Impact of return on Control Flow

Using Return Values in Expressions

Ready to keep this from fading?

The `return` Statement

Implicit `None` Returns

The Impact of `return` on Control Flow