《Python真好玩,教孩子学编程》小挑战【转载】
第九章,注释帮助我们理解
书籍《Python真好玩,教孩子学编程》
幽默风趣地讲解了注释的重要性以及如何写注释
(1)理解这段代码,并给它添加注释,让别人看了你的注释就能理解这段代码。
def mul(num1,num2):
res = num1 * num2
global tip #强制tip是全局变量的tip
tip= "在乘法函数中修改值"
print(tip)
return res
tip="我是主函数中定义的变量"
result = mul(4,5)
print("乘法的结果为:")
print (result)
print(tip)
运行程序,结果为:
解析:
要给代码添加注释,首先要理解代码的含义,所以首先来看下代码,理解它的含义。
在这段代码中,首先定义了函数mul(),函数的主要功能是计算两个数的乘积。
但是这段代码还额外考察了局部变量和全局变量的知识。
在主函数中定义了一个全局变量tip,
在mul()函数中定义了变量tip,按道理tip是局部变量,但是在tip前面加了global,
tip被强制为主函数中的全局变量tip,所以在mul()函数中对tip进行修改,修改的是
主函数中的全局变量tip的值。
这一点,从程序的运行结果便知。
了解了代码的含义,接下来写注释就变得很简单。
'''
作者:小溪流
功能:计算两个数的乘积
入参:num1为数字类型,num2为数字类型
返回值:两个数的乘积
'''
def mul(num1,num2):
#计算两个数的乘积
res = num1 * num2
#强制tip是全局变量的tip
global tip
#修改全局变量tip的值
tip= "在乘法函数中修改值"
print(tip)
return res
tip="我是主函数中定义的变量"
#调用mul()函数,result变量接收返回值
result = mul(4,5)
print("乘法的结果为:")
print (result)
print(tip)