Of course! The return statement in Python is used to exit a function and send a value back to the caller. When you want to return an integer, you simply use the return keyword followed by an integer value or an expression that evaluates to an integer.
Here’s a complete breakdown with examples.
The Basic Syntax
The core syntax is straightforward:
def function_name():
# ... some code ...
return <some_integer>
When Python executes the return statement, it immediately stops running the function and sends the specified value back.
Simple Example: Returning a Literal Integer
This is the most basic case where the function returns a hard-coded integer.
def get_status_code():
"""Returns a standard HTTP status code."""
return 200
# How to use it
status = get_status_code()
print(status)
# Output: 200
print(f"The status is: {status}")
# Output: The status is: 200
Example: Returning the Result of an Expression
You can also return the result of any calculation or expression that results in an integer.
def add_numbers(a, b):
"""Adds two numbers and returns their sum."""
return a + b
# How to use it
sum_result = add_numbers(5, 7)
print(sum_result)
# Output: 12
# You can use it directly in another expression
if add_numbers(10, 5) > 14:
print("The sum is greater than 14.")
# Output: The sum is greater than 14.
Example: Returning Based on a Condition
A very common pattern is to return different integers depending on the logic inside the function.
def check_even_odd(number):
"""Checks if a number is even or odd and returns 0 or 1."""
if number % 2 == 0:
return 0 # Represents 'even'
else:
return 1 # Represents 'odd'
# How to use it
is_even = check_even_odd(10)
is_odd = check_even_odd(7)
print(f"Is 10 even? {is_even == 0}") # Output: Is 10 even? True
print(f"Is 7 odd? {is_odd == 1}") # Output: Is 7 odd? True
The int() Constructor vs. return int
It's important not to confuse the return statement with the int() constructor. They are used for different purposes.
return statement |
int() constructor |
|---|---|
| Purpose: Exits a function and sends a value back. | Purpose: Converts a value (like a string or float) into an integer. |
Syntax: return <value> |
Syntax: int(<value_to_convert>) |
Example: return 42 |
Example: return int("42") |
Here is an example that uses both:
def convert_to_int(string_value):
"""
Takes a string, converts it to an integer, and returns it.
"""
# We use int() to perform the conversion
converted_number = int(string_value)
# We use return to send the final integer value back
return converted_number
# How to use it
my_number = convert_to_int("123")
print(my_number)
# Output: 123
print(type(my_number))
# Output: <class 'int'>
Key Points to Remember
-
A function can have multiple
returnstatements. As soon as one is executed, the function stops.def compare(a, b): if a > b: return 1 elif a < b: return -1 else: return 0 -
If a function finishes without a
returnstatement, it implicitly returnsNone.def say_hello(): print("Hello!") result = say_hello() print(result) # Output: # Hello! # None -
You can only return one value. However, you can "return" multiple values by packing them into a tuple, which is a common and Pythonic way to do it.
def get_user_info(): """Returns a user's ID and name.""" user_id = 101 user_name = "Alice" # This returns a tuple: (101, "Alice") return user_id, user_name # You can "unpack" the tuple into separate variables id, name = get_user_info() print(f"User ID: {id}, Name: {name}") # Output: User ID: 101, Name: Alice
