HumachLearnLearn · explore · apply
Start learning
Functions & Reusable Code · Lesson 60

Return Values

Return Values concerns reusable Python functions.

ConceptWorked examplePracticeKnowledge check
Textbook walkthrough

What Return Values actually means

Return Values concerns reusable Python functions. A function packages a sequence of statements behind a name, receives inputs through parameters and can return an output. Functions create local scope and are first-class objects, so they can be stored, passed and composed.

Return Values matters because functions are the main unit for turning repeated logic into reusable, testable interfaces. Clear inputs, scope and returned outputs make larger programs easier to reason about than long sequences of top-level statements.

Deeper walkthrough

Read Return Values as a mechanism, not a recipe

Treat this as a sequence of observable decisions rather than one opaque command. Stage 1: Define the function with def (or a lambda for a small expression). Stage 2: Bind supplied arguments to parameters when the function is called. Stage 3: Execute the indented function body in a local scope. Final checkpoint: Use docstrings and type hints to communicate intent; use *args/**kwargs only when variable argument structure is genuinely useful.

Mechanism

Follow the transformation

Define the function with def (or a lambda for a small expression).

Bind supplied arguments to parameters when the function is called.

Execute the indented function body in a local scope.

Evidence

Know what would convince you

  • Run the operation on a tiny literal input and write the expected type/value before executing it.
  • Inspect the relevant object state before and after the operation, especially when mutable objects are involved.
Useful distinctionparameter: Name in the function definition.
Visual demonstration of Return Values
Visual demonstration: use the diagram to trace the main objects and state changes involved in Return Values.
Click a stage to inspect what happens, what changes, and what should be checked before moving on.
Stage 1

Define the function with def (or…

Define the function with def (or a lambda for a small expression). This is an input-preparation stage for Return Values. Verify the relevant type, shape, units, keys, missingness or assumptions before later steps depend on them.

Input focus: confirm the data/object, units, type, shape and assumptions before the next operation depends on them.
How it works

Trace the mechanism step by step

  1. Define the function with def (or a lambda for a small expression).
  2. Bind supplied arguments to parameters when the function is called.
  3. Execute the indented function body in a local scope.
  4. return sends a value back to the caller and stops that call; without an explicit return, the result is None.
  5. Use docstrings and type hints to communicate intent; use *args/**kwargs only when variable argument structure is genuinely useful.
Worked demonstration

Make the concept concrete

Demonstration

Python example

# Step 1 — Define the reusable `kpi_rate` function; its indented body describes what happens for each call.
def kpi_rate(successes: int, total: int = 100) -> float:
    # Step 2 — Execute this statement and inspect how it changes the current value, object or program state.
    """Return success percentage; reject impossible denominators."""
    # Step 3 — Evaluate this condition and execute the indented branch only when the condition is true.
    if total <= 0:
        # Step 4 — Raise an explicit exception to signal that the required condition or input contract was violated.
        raise ValueError("total must be positive")
    # Step 5 — Return the computed value to the caller so the result can be reused or tested.
    return 100 * successes / total

# Step 6 — Display the current value explicitly so the result/state can be inspected during execution.
print(kpi_rate(42, 60))
# Step 7 — Display the current value explicitly so the result/state can be inspected during execution.
print(kpi_rate(successes=75))
Expected / illustrative result
70.0
75.0
Interpret the result.

For Return Values, connect the displayed result to the specific input and mechanism above; independently verify one value/state change rather than treating successful execution as proof.

Distinctions & related ideas

Know what this is — and what it is not

parameterName in the function definition.
argumentValue supplied at a call site.
returnValue sent back to the caller.
yieldProduces a sequence lazily from a generator, pausing function state between values.
Use deliberately

When it is appropriate

Use Return Values when the program genuinely needs this language behaviour and you can state the input object, resulting value/state and expected failure behaviour.

Boundary conditions

When to stop or reconsider

Choose a clearer built-in, data structure or control-flow pattern when it expresses the intent more directly; stop if implicit conversion, mutation or hidden state makes the behaviour hard to reason about.

Common mistakes

Failure modes to recognise

  • Applying the operation to an incompatible type or assuming Python will silently coerce values the way you intended.
  • Confusing a returned value with an in-place mutation or other side effect.
  • Testing only the happy path and missing empty, boundary or invalid inputs.
Verification

How to check the result

  • Run the operation on a tiny literal input and write the expected type/value before executing it.
  • Inspect the relevant object state before and after the operation, especially when mutable objects are involved.
  • Try one boundary or invalid input and confirm that the returned value or exception matches the intended contract.
Hands-on practice

Demonstrate understanding

Try this:

Build a tiny, inspectable example of Return Values. First define the function with def (or a lambda for a small expression). Then bind supplied arguments to parameters when the function is called. Write the expected result before running it, and explain one condition that would make the result misleading or invalid.

Use the smallest values that expose the rule. Write the expected value and type first, then compare Python’s actual state/output with that prediction.
Knowledge check

Check reasoning, not memorisation

Before trusting a result from Return Values, which check provides the strongest evidence that you understand and applied it correctly?

Quick reference

Keep the important distinctions visible

Step 1Define the function with def (or a lambda for a small expression).
Step 2Bind supplied arguments to parameters when the function is called.
Step 3Execute the indented function body in a local scope.
Step 4return sends a value back to the caller and stops that call; without an explicit return, the result is None.
Lesson summary

What to remember

  • Return Values concerns reusable Python functions. A function packages a sequence of statements behind a name, receives inputs through parameters and can return an output. Functions create local scope and are first-class objects, so they can be stored, passed and composed.
  • Define the function with def (or a lambda for a small expression).
  • Applying the operation to an incompatible type or assuming Python will silently coerce values the way you intended.
  • Run the operation on a tiny literal input and write the expected type/value before executing it.