课程笔记函数（形参和实参-文档字符串-函数注释）

形参和实参
【操作】定义一个函数，实现两个数的比较，并返回较大的值。
代码

#测试形参、实参的基本用法
#形参用于定义
def printMax(a,b):#a,b称为形式参数
print(c)
    if a>b:#这里a,b为局部变量
        print(a,"较大值")
    else:
        print(b,"较大值")
#实参用于调用
printMax(10,20)#这里10,20就是实际参数
printMax(200,300)

执行结果

20 较大值
300 较大值

上面的 printMax 函数中，在定义时写的 printMax(a,b)。a 和 b 称为“形式参数”，
简称“形参”。也就是说，形式参数是在定义函数时使用的。 形式参数的命名只要符合“标
识符”命名规则即可。
在调用函数时，传递的参数称为“实际参数”，简称“实参”。上面代码中，
printMax(10,20)，10 和 20 就是实际参数。

#printMax()#不能少调参数
#printMax(200,300,400)#也不能多调参数
#他需要一一对应

文档字符串(函数的注释)
程序的可读性最重要，一般建议在函数体开始的部分附上函数定义说明，这就是“文档字符串”，也有人成为“函数的注释”。我们通过三个单引号或者三个双引号来实现，中间可以加入多行文字进行说明。

【操作】测试文档字符串的使用

def print_star(n):
    '''根据传入的 n，打印多个星号'''
    print("*"*n)
help(print_star)

我们调用 help(函数名.doc)可以打印输出函数的文档字符串。执行结果如下：

Help on function print_star in module __main__:
print_star(n)
根据传入的 n，打印多个星号

源代码：

#测试形参、实参的基本用法
#形参用于定义
def printMax(a,b):#a,b称为形式参数
# 文档字符串(函数的注释)(可通过三个单引号或三个双引号定义多行注释)
    '''用于比较两个数的大小，打印较大的值'''
    c = '''
         ddd
         dsc
         fef
    '''
    print(c)
    if a>b:#这里a,b为局部变量
        print(a,"较大值")
    else:
        print(b,"较大值")
#实参用于调用
printMax(10,20)#这里10,20就是实际参数
printMax(200,300)

#printMax()#不能少调参数
#printMax(200,300,400)#也不能多调参数
#他需要一一对应

#文档字符串(函数的注释)(可通过三个单引号或三个双引号定义多行注释)
help(printMax.__doc__)#打印输出函数的文档字符串

结果

         ddd
         dsc
         fef
    
20 较大值

         ddd
         dsc
         fef
    
300 较大值
No Python documentation found for '用于比较两个数的大小，打印较大的值'.
Use help() to get the interactive help utility.
Use help(str) for help on the str class.