15_ Python基础到实战一飞冲天(二)-python基础(十五)--函数2

# 15_ Python基础到实战一飞冲天（二）-python基础（十五）--函数2

## 一、函数基本使用-06-函数的文档注释

### 1、 函数的文档注释

1）在开发中，如果希望给函数添加注释，应该在 **定义函数** 的下方，使用 **连续的三对引号**。

2）在 **连续的三对引号** 之间编写对函数的说明文字。

3）在 **函数调用** 位置，使用快捷键 `CTRL + Q` 可以查看函数的说明信息。

即点击 PyCharm ---> View ---> Quick Documentation

### 2、注意：因为 **函数体相对比较独立**，**函数定义的上方**，应该和其他代码（包括注释）保留 **两个空行**。

### 3、函数的文档注释 示例

```python

# dzs_04_第一个函数改进.py

name = "小明"

# 1.定义函数，解释器知道这里定义了一个函数，只是表示封装了一段代码而已，但不会执行

def say_hello():

"""打招呼"""

print("hello 1")

print("hello 2")

print("hello 3")

print(name)

# 2.调用函数：只有在调用函数时，之前定义的函数才会被执行

say_hello()

print(name)

```

## 二、函数参数-01-没有参数的函数过于死板

### 1、函数的参数：**演练需求**

1）开发一个 `sum_2_num` 的函数。

2）函数能够实现 **两个数字的求和** 功能。

### 2、演练代码如下（函数过于死板）：

```python

# dzs_05_函数的参数.py

def sum_2_num():

"""对两个数字的求和"""

num1 = 10

num2 = 20

result = num1 + num2

print("%d + %d = %d" % (num1, num2, result))

sum_2_num()

```

### 3、**思考一下上述函数代码存在什么问题**

> 函数只能处理 **固定数值** 的相加。

**如何解决？**

* 如果能够把需要计算的数字，在调用函数时，传递到函数内部就好了！

### 4、对两个数字的求和 函数（函数过于死板） 示例

## 三、函数参数-02-函数参数的使用以及作用

### 1、 函数参数的使用

1）在函数名的后面的小括号内部填写 **参数**。

2）多个参数之间使用 `,` 分隔。

```python

def sum_2_num(num1, num2):

result = num1 + num2

print("%d + %d = %d" % (num1, num2, result))

sum_2_num(50, 20)

```

### 2、函数参数的作用

1）**函数**，把 **具有独立功能的代码块** 组织为一个小模块，在需要的时候 **调用**。

2）**函数的参数**，增加函数的 **通用性**，针对 **相同的数据处理逻辑**，能够 **适应更多的数据**。

* 在函数 **内部**，把参数当做 **变量** 使用，进行需要的数据处理。

* 函数调用时，按照函数定义的**参数顺序**，把 **希望在函数内部处理的数据**，**通过参数** 传递。

### 3、改进两个数求和函数代码

```python

# dzs_05_函数的参数.py

def sum_2_num(num1, num2):

"""对两个数字的求和"""

# num1 = 10

# num2 = 20

result = num1 + num2

print("%d + %d = %d" % (num1, num2, result))

sum_2_num(30, 50)

```

### 4、通过单步调试，观察函数参数传值

## 四、函数参数-03-形参和实参

### 1、形参和实参

1）**形参**：**定义** 函数时，小括号中的参数，是用来接收参数用的，在函数内部 **作为变量使用**。

2）**实参**：**调用** 函数时，小括号中的参数，是用来把数据传递到 **函数内部** 用的。

### 2、形参实参示例图

## 五、函数的返回值-01-返回值的应用场景和格式

### 1、函数的返回值

1）在程序开发中，有时候，会希望 **一个函数执行结束后，告诉调用者一个结果**，以便调用者针对具体的结果做后续的处理。

2）**返回值** 是函数 **完成工作**后，**最后** 给调用者的 **一个结果**。

3）在函数中使用 `return` 关键字可以返回结果。

4）调用函数一方，可以 **使用变量** 来 **接收** 函数的返回结果。

### 2、注意：`return` 表示返回，后续的代码都不会被执行。

### 3、函数返回值示例代码

```python

def sum_2_num(num1, num2):

"""对两个数字的求和"""

return num1 + num2

# 调用函数，并使用 result 变量接收计算结果

result = sum_2_num(10, 20)

print("计算结果是 %d" % result)

```

## 六、函数的返回值-02-改造求和函数

### 1、函数返回值案例代码

```python

# dzs_06_函数的返回值.py

def sum_2_num(num1, num2):

"""对两个数字的求和"""

result = num1 + num2

# 可以使用返回值，告诉调用函数一方计算的结果

return result

# 可以使用变量来接收函数执行的返回结果

sum_result = sum_2_num(30, 50)

print("两个数求和结果是：%d " % sum_result)

```

### 2、函数返回值示例

## 七、函数的返回值-03-retrun关键字的注意事项

### 1、> 注意：`return` 表示返回，后续的代码都不会被执行。

### 2、如下

```python

# dzs_06_函数的返回值.py

def sum_2_num(num1, num2):

"""对两个数字的求和"""

result = num1 + num2

# 可以使用返回值，告诉调用函数一方计算的结果

return result

# return 表示返回，下方的代码都不会被执行

# num = 100

# 可以使用变量来接收函数执行的返回结果

sum_result = sum_2_num(30, 50)

print("两个数求和结果是：%d " % sum_result)

```

## 八、函数的嵌套调用-01-函数嵌套调用的执行线路图

### 1、函数的嵌套调用

1）一个函数里面 **又调用** 了 **另外一个函数**，这就是 **函数嵌套调用**。

2）如果函数 `test2` 中，调用了另外一个函数 `test1`

* 那么执行到调用 `test1` 函数时，会先把函数 `test1` 中的任务都执行完。

* 才会回到 `test2` 中调用函数 `test1` 的位置，继续执行后续的代码。

### 2、函数的嵌套调用 示例代码

```python

# dzs_07_函数的嵌套调用.py

def test1():

print("*" * 50)

def test2():

print("-" * 50)

test1()

print("=" * 50)

test2()

```

### 3、示例：

## 九、函数的嵌套调用-02-[扩展]用百度网站举例说明函数的调用线路

### 1、例如 www.baidu.com 搜索 unix 跳转到搜索页面，如：百度百科（相当于一个函数）又可点击跳转。

### 2、点击百度百科后，在此页面又发现“类UNIX操作系统”（相当于另外一个函数）可点击跳转。

## 十、分隔线演练-01-利用参数增加分隔线的灵活度

### 1、函数嵌套的演练 —— 打印分隔线

> 体会一下工作中 **需求是多变** 的。

1）**需求 1**

* 定义一个 `print_line` 函数能够打印 `*` 组成的 **一条分隔线**。

```python

def print_line(char):

print("*" * 50)

```

2）**需求 2**

* 定义一个函数能够打印 **由任意字符组成** 的分隔线。

```python

def print_line(char):

print(char * 50)

```

3）**需求 3**

* 定义一个函数能够打印 **任意重复次数** 的任意分隔线。

```python

def print_line(char, times):

print(char * times)

```

### 2、函数嵌套的演练：打印分隔线 代码

```python

# dzs_08_函数的嵌套演练_打印分隔线.py

def print_line_01():

print("*" * 50)

def print_line_02(char):

print(char * 50)

def print_line_03(char, times):

print(char * times)

print_line_01()

print_line_02("=")

print_line_03("OK", 25)

```

### 3、函数嵌套的演练：打印分隔线 示例

`上一节关联链接请点击：`

14_ Python基础到实战一飞冲天（二）-python基础（十四）--函数1