Functions in Python

Analogy categoryAnalogies

1. Introduction

A function is a named, reusable block of code that performs a specific task. Functions let you break a large program into smaller, manageable pieces, avoid repeating code, and make programs easier to read, test, and debug. Python has built-in functions such as print() and len(), but you can also define your own using the def keyword.

🏏

Cricket analogy: A 'run drill' routine that a coach can call for any player breaks fielding training into a repeatable, focused task rather than re-explaining footwork from scratch every time, just like Python's built-in print() being ready to use alongside a coach's own custom drills.

Once defined, a function can be called any number of times with different inputs, which makes your code more modular and maintainable than writing the same logic repeatedly.

🏏

Cricket analogy: Once a fielding coach designs the 'high catch drill', it can be run with any player and any ball speed, session after session, without redesigning the drill each time a new recruit joins the academy.

2. Syntax

python

def function_name(parameter1, parameter2):
    """Optional docstring describing the function."""
    # function body
    result = parameter1 + parameter2
    return result

3. Explanation

The def keyword starts a function definition, followed by the function name and a parenthesized list of parameters. The colon begins an indented code block that forms the function body. The optional return statement sends a value back to the caller and immediately exits the function; if a function reaches its end without a return statement, it implicitly returns None.

🏏

Cricket analogy: A coaching manual begins a drill with 'Drill:' followed by its name and a list of required equipment in parentheses; the colon marks where the step-by-step instructions begin, and an optional 'result' line at the end reports the outcome and immediately ends the drill — if no result line is given, the drill simply ends with no reported score.

A docstring, written as the first statement in the function body using triple quotes, documents what the function does and can be accessed later via function_name.__doc__ or the help() function.

🏏

Cricket analogy: A drill card's first line under the title, written in italics, explains what the drill trains and can be read later by any coach flipping through the manual's index or asking for the drill's description at a glance.

A function that only prints values and has no return statement still 'returns' something: Python automatically returns None. Beginners often mistakenly assume a function that prints its result has also returned that value to the caller.

4. Example

python

def greet(name):
    """Return a greeting message for the given name."""
    message = f"Hello, {name}! Welcome to Python."
    return message


def log_greet(name):
    print(f"Logging: greeting {name}")
    # no return statement


result1 = greet("Asha")
print(result1)

result2 = log_greet("Ravi")
print(result2)

print(greet.__doc__)

5. Output

text

Hello, Asha! Welcome to Python.
Logging: greeting Ravi
None
Return a greeting message for the given name.

6. Key Takeaways

Functions are defined with the def keyword and can accept parameters and return values.
A function without an explicit return statement implicitly returns None.
Docstrings document a function's purpose and are accessible via __doc__.
Calling a function executes its body top to bottom until a return statement or the end of the block.
Functions promote code reuse, readability, and easier testing/debugging.