- 函数的定义
- 变量作用域:局部变量和全局变量
- 函数的参数类型:位置参数、默认参数、不定参数
- 传递参数的手段:关键词参数
- 传递参数的顺序:同时出现三种参数类型时
函数的定义
函数的基本写法:
def function_name(parameter1, parameter2, ...):
"""
Docstring: 描述函数的功能、参数和返回值 (可选但强烈推荐)
"""
# 函数体: 实现功能的代码
# ...
return value # 可选,用于返回结果
- def: 关键字,表示开始定义一个函数。
- function_name: 函数的名称,应遵循Python的命名约定(通常是小写字母和下划线,例如 calculate_area,用英文单词含义和下划线来作为函数名)。
- parameter1, parameter2, ... : 函数的参数(也叫形参),是函数在被调用时接收的输入值。参数是可选的。
- ( ): 参数列表必须放在圆括号中,即使没有参数,括号也不能省略。
- : 冒号表示函数定义的头部结束,接下来是缩进的函数体。
- Docstring (文档字符串): 位于函数定义第一行的多行字符串(通常用三引号 """Docstring goes here""")。用于解释函数的作用、参数、返回值等。可以通过 help(function_name) 或 function_name.__doc__ 查看。这个写法可选,为了后续维护和查看,建议加上这一段更加规范
- 函数体 (Function Body): 缩进的代码块,包含实现函数功能的语句。
- return value: return 语句用于从函数中返回一个值。如果函数没有 return 语句,或者 return 后面没有值,它会自动返回 None。一个函数可以有多个 return 语句(例如在不同的条件分支中)。
不带参数的函数
# 定义一个简单的问候函数
def greet():
"""打印一句问候语。"""
message = "大家好!欢迎学习Python函数定义!"
print(message)
greet()
可以看到上述函数没有参数,也没有返回值,调用这个函数的时候运行函数体中的内容
带参数的函数
函数的参数我们有如下称呼:
- Parameters (形参): 在函数定义中列出的变量名 (如 name, feature1, feature2)。
- Arguments (实参): 在函数调用时传递给函数的实际值 (如 "张三", 10, 25),也就是实际的数值(实参)传给了 形参(定义时候的变量)
注意: 定义的时候把函数的参数称之为形参,调用的时候把函数的参数称之为实参。
# 定义一个带多个参数的函数 (例如,在机器学习中计算两个特征的和)
def add_features(feature1, feature2):
"""计算两个数值特征的和。
Args:
feature1 (float or int): 第一个特征值。
feature2 (float or int): 第二个特征值。
"""
total = feature1 + feature2
print(f"{feature1} + {feature2} = {total}")
add_features(10, 25) # 输出: 10 + 25 = 35
带返回值的函数
函数不仅可以执行操作(如打印),还可以计算并返回一个结果
# 定义一个计算和并返回结果的函数
def calculate_sum(a, b):
"""计算两个数的和并返回结果。
Args:
a (float or int): 第一个数。
b (float or int): 第二个数。
Returns:
float or int: 两个数的和。
"""
result = a + b
return result
print("hhh")
calculate_sum(2, 3) # 输出: 5
此时,注意到,print("hhh")这个代码并没有被执行,因为函数在遇到return语句时,就会立即返回,而不会继续执行函数后面的代码。
其次,如果没有return语句,或者return后面不带任何参数,那么函数也会返回None(不要把执行的操作理解为返回值)。
变量作用域:局部变量和全局变量
- 局部变量 (Local Variables): 在函数内部定义的变量,只在该函数内部有效。当函数执行完毕后,局部变量通常会被销毁。
- 全局变量 (Global Variables): 在所有函数外部定义的变量,可以在程序的任何地方被访问(但在函数内部修改全局变量需要特殊声明,如 global 关键字,初学阶段可以先避免)。
print("\n--- 变量作用域示例 ---")
global_var = "我是一个全局变量"
def scope_test():
local_var = "我是一个局部变量"
print(f"在函数内部,可以看到局部变量: '{local_var}'")
print(f"在函数内部,也可以看到全局变量: '{global_var}'")
# global_var = "尝试在函数内修改全局变量" # 如果没有 global 声明,这会创建一个新的局部变量 global_var
# print(f"在函数内部,修改后的 '全局' 变量: '{global_var}'")
scope_test()
print(f"\n在函数外部,可以看到全局变量: '{global_var}'")
# 输出
--- 变量作用域示例 ---
在函数内部,可以看到局部变量: '我是一个局部变量'
在函数内部,也可以看到全局变量: '我是一个全局变量'
在函数外部,可以看到全局变量: '我是一个全局变量'
函数的参数类型
参数有以下类型:
- 位置参数 (Positional Arguments): 调用时按顺序匹配。
- 默认参数值 (Default Parameter Values): 定义函数时给参数指定默认值,调用时如果未提供该参数,则使用默认值。
- 可变数量参数 (*args 和 **kwargs):
- *args: 将多余的位置参数收集为一个元组。
- **kwargs: 将多余的关键字参数收集为一个字典。
可能你还听过关键字参数 (Keyword Arguments)这个说法,但是他并非是一种参数,而是一种传递参数的手段: 调用时通过 参数名=值 的形式指定,可以不按顺序。他可以传位置参数的值,也可以传默认参数的值,也可以传可变参数的值,也可以传关键字参数的值。为了可读性,更推荐对所有参数均采取关键字参数传递。
位置参数
def describe_pet(animal_type, pet_name):
"""显示宠物的信息。"""
print(f"\n我有一只 {animal_type}.")
print(f"我的 {animal_type} 的名字叫 {pet_name.title()}.")
describe_pet("猫", "咪咪") # 使用关键字参数,顺序不重要
为了可读性,更推荐对所有参数采取关键词参数的写法
当一个函数有很多参数时,如果只用位置参数,调用者可能需要反复查看函数定义才能确定每个参数的含义。使用关键字参数,每个值的含义都通过其前面的参数名清晰地标示出来。
describe_pet(animal_type="猫", pet_name="咪咪") # 使用关键字参数,顺序不重要
describe_pet(pet_name="旺财", animal_type="狗") # 顺序改变,但结果正确
默认参数
注意:带默认值的参数必须放在没有默认值的参数之后
def describe_pet_default(pet_name, animal_type="狗"): # animal_type 有默认值
"""显示宠物的信息,动物类型默认为狗。"""
print(f"我有一只 {animal_type}.")
print(f"我的 {animal_type} 的名字叫 {pet_name.title()}.")
describe_pet_default(pet_name="小黑") # animal_type 使用默认值 "狗"
describe_pet_default(pet_name="雪球", animal_type="仓鼠") # 提供 animal_type,覆盖默认值
# 注意:带默认值的参数必须放在没有默认值的参数之后
可变数量参数
1. *args (收集位置参数)
*args: 将多余的位置参数收集为一个元组。
当函数被调用时,Python 会先尝试用调用时提供的位置参数去填充函数定义中所有明确定义的、非关键字的形参 (也就是那些普通的,没有 * 或 ** 前缀的参数,包括有默认值的和没有默认值的)。
如果在填充完所有这些明确定义的形参后,调用时还有剩余的位置参数,那么这些“多余的”位置参数就会被收集起来,形成一个元组 (tuple),并赋值给 *args 指定的那个变量(通常就是 args)。
如果调用时提供的位置参数数量正好等于或少于明确定义的形参数量(且满足了所有必需参数),那么 *args 就会是一个空元组 ( )。
def make_pizza(size, *toppings):
"""概述要制作的比萨。
*toppings 会将所有额外的位臵参数收集到一个元组中。
"""
print(f"\n制作一个 {size} 寸的比萨,配料如下:")
if toppings: # 只要toppings不为空元组,就会执行
for topping in toppings:
print(f"- {topping}")
else:
print("- 原味 (无额外配料)")
make_pizza(12, "蘑菇")
make_pizza(16, "香肠", "青椒", "洋葱")
make_pizza(9) # toppings 会是空元组
# 输出:
制作一个 12 寸的比萨,配料如下:
- 蘑菇
制作一个 16 寸的比萨,配料如下:
- 香肠
- 青椒
- 洋葱
制作一个 9 寸的比萨,配料如下:
- 原味 (无额外配料)
2. **kwargs (收集关键字参数)
**kwargs: 将多余的关键字参数收集为一个字典。
当函数被调用时,Python 会先处理完所有的位置参数(包括填充明确定义的形参和收集到 *args 中)。
然后,Python 会看调用时提供的关键字参数 (形如 name=value)。它会尝试用这些关键字参数去填充函数定义中所有与关键字同名的、明确定义的形参(这些形参可能之前没有被位置参数填充)。
如果在填充完所有能通过名字匹配上的明确定义的形参后,调用时还有剩余的关键字参数(即这些关键字参数的名字在函数定义中没有对应的明确形参名),那么这些“多余的”关键字参数就会被收集起来,形成一个字典 (dictionary),并赋值给 **kwargs 指定的那个变量(通常就是 kwargs)。
如果调用时提供的所有关键字参数都能在函数定义中找到对应的明确形参名,那么 **kwargs 就会是一个空字典 { }。
def build_profile(first_name, last_name, **user_info):
"""创建一个字典,其中包含我们知道的有关用户的一切。
**user_info 会将所有额外的关键字参数收集到一个字典中。
"""
profile = {}
profile['first_name'] = first_name
profile['last_name'] = last_name
for key, value in user_info.items():
profile[key] = value
return profile
user_profile = build_profile('爱因斯坦', '阿尔伯特',
location='普林斯顿',
field='物理学',
hobby='小提琴')
print(f"\n用户信息: {user_profile}")
# 输出: {'first_name': '爱因斯坦', 'last_name': '阿尔伯特', 'location': '普林斯顿', 'field': '物理学', 'hobby': '小提琴'}
*args 和 **kwargs 的核心目的是让函数能够接收不定数量的参数,并以元组和字典的形式在函数内部进行处理。
也就是说,当位置参数用完了 就自动变成*args,当关键词参数用完了 就自动变成**kwarges
作业:
题目1:计算圆的面积
- 任务: 编写一个名为 calculate_circle_area 的函数,该函数接收圆的半径 radius 作为参数,并返回圆的面积。圆的面积 = π * radius² (可以使用 math.pi 作为 π 的值)
- 要求:函数接收一个位置参数 radius。计算半径为5、0、-1时候的面积
- 注意点:可以采取try-except 使函数变得更加稳健,如果传入的半径为负数,函数应该返回 0 (或者可以考虑引发一个ValueError,但为了简单起见,先返回0)。
def calculate_circle_area(radius):
"""计算圆的面积,接收半径作为参数,返回圆的面积。
当半径为负数时返回0,当半径非数字时抛出TypeError。"""
try:
# 尝试将输入转换为浮点数
radius = float(radius)
# 检查半径是否为负数
if radius < 0:
return 0
# 计算并返回面积
return math.pi * (radius ** 2)
except (ValueError, TypeError):
# 处理无法转换为数字的情况
raise TypeError("半径必须是一个数字")
# 测试用例
print(calculate_circle_area(5)) # 输出约78.53981633974483
print(calculate_circle_area(0)) # 输出0.0
print(calculate_circle_area(-1)) # 输出0
print(calculate_circle_area(5.5)) # 输出约95.03317777109125
题目2:计算矩形的面积
- 任务: 编写一个名为 calculate_rectangle_area 的函数,该函数接收矩形的长度 length 和宽度 width 作为参数,并返回矩形的面积。
- 公式: 矩形面积 = length * width
- 要求:函数接收两个位置参数 length 和 width。
- 函数返回计算得到的面积。
- 如果长度或宽度为负数,函数应该返回 0。
def calculate_rectangle_area(length, width):
"""计算矩形的面积,接收长度和宽度作为参数,返回矩形的面积。
当长度或宽度为负数时返回0"""
try:
# 尝试将输入转换为浮点数
length = float(length)
width = float(width)
# 检查长度或宽度是否为负数
if length < 0 or width < 0:
return 0
# 计算并返回面积
return length * width
except (ValueError, TypeError):
# 处理无法转换为数字的情况
raise TypeError("长度和宽度必须是数字")
# 测试用例
print(calculate_rectangle_area(5, 3)) # 输出15
print(calculate_rectangle_area(0, 5)) # 输出0.0
print(calculate_rectangle_area(-1, 5)) # 输出0
print(calculate_rectangle_area(5.5, 3.2)) # 输出17.6
题目3:计算任意数量数字的平均值
- 任务: 编写一个名为 calculate_average 的函数,该函数可以接收任意数量的数字作为参数(引入可变位置参数 (*args)),并返回它们的平均值。
- 要求:使用 *args 来接收所有传入的数字。
- 如果没有任何数字传入,函数应该返回 0。
- 函数返回计算得到的平均值。
def calculate_average(*args):
"""计算任意数量数字的平均值。
接收可变数量的数字参数,返回它们的平均值。
如果没有传入参数,返回0。"""
if not args:
return 0
try:
# 计算总和
total = sum(args)
# 计算平均值
return total / len(args)
except TypeError:
raise TypeError("所有参数必须是数字类型")
# 测试用例
print(calculate_average(1, 2, 3, 4, 5)) # 输出3.0
print(calculate_average(10, 20)) # 输出15.0
print(calculate_average(5)) # 输出5.0
print(calculate_average()) # 输出0
print(calculate_average(1.5, 2.5, 3.5)) # 输出2.5
题目4:打印用户信息
- 任务: 编写一个名为 print_user_info 的函数,该函数接收一个必需的参数 user_id,以及任意数量的额外用户信息(作为关键字参数)。
- 要求:
- user_id 是一个必需的位置参数。
- 使用 **kwargs 来接收额外的用户信息。
- 函数打印出用户ID,然后逐行打印所有提供的额外信息(键和值)。
- 函数不需要返回值
def print_user_info(user_id, **kwargs):
"""打印用户ID和额外的用户信息。
user_id: 必需的位置参数,用户ID
**kwargs: 可选的关键字参数,包含其他用户信息"""
print(f"User ID: {user_id}")
for key, value in kwargs.items():
print(f"{key.capitalize()}: {value}")
# 测试用例
print_user_info(12345, name="Alice", age=30, city="New York")
print("\n")
print_user_info(67890, username="bob_smith", email="bob@example.com", country="Canada", active=True)
print("\n")
print_user_info(54321)
题目5:格式化几何图形描述
- 任务: 编写一个名为 describe_shape 的函数,该函数接收图形的名称 shape_name (必需),一个可选的 color (默认 “black”),以及任意数量的描述该图形尺寸的关键字参数 (例如 radius=5 对于圆,length=10, width=4 对于矩形)。
- 要求:shape_name 是必需的位置参数。
- color 是一个可选参数,默认值为 “black”。
- 使用 **kwargs 收集描述尺寸的参数。
- 函数返回一个描述字符串,格式如下:
- “A [color] [shape_name] with dimensions: [dim1_name]=[dim1_value], [dim2_name]=[dim2_value], …”如果 **kwargs 为空,则尺寸部分为 “with no specific dimensions.”
def describe_shape(shape_name, color="black", **kwargs):
"""格式化几何图形的描述信息。
shape_name: 必需的位置参数,图形名称
color: 可选参数,颜色,默认为"black"
**kwargs: 可选的关键字参数,描述图形尺寸"""
dimensions = ", ".join([f"{k}={v}" for k, v in kwargs.items()]) if kwargs else "no specific dimensions"
return f"A {color} {shape_name} with dimensions: {dimensions}."
# 测试用例
print(describe_shape("circle", "red", radius=5))
print(describe_shape("rectangle", length=10, width=4))
print(describe_shape("square", "blue", side=5))
print(describe_shape("triangle"))
print(describe_shape("ellipse", "purple", major_axis=10, minor_axis=6))