"""
1.函数的快速体验
2.函数的基础运用
3.函数的参数
4.函数的返回值
5.函数的嵌套调用
6.在模块中定义函数
"""
"""
1.1 快速体验
所谓函数，就是把 具有独立功能的代码块 组织为一个小模块，在需要的时候 调用
函数的使用包含两个步骤：
定义函数 —— 封装 独立的功能
调用函数 —— 享受 封装 的成果
函数的作用，在开发程序时，使用函数可以提高编写的效率以及代码的 重用
"""
# 引入封装好的函数
"""
hm_函数_输出九九乘法表.py
# 制作九九乘法表
def multiple_table() -> object:
i = 1
while i <= 9:
# 定义一个列计数器
col = 1
# 开始循环
while col <= i:
# print("%d" % i, end="")
print("%d * %d = %d" % (col, i, col*i), end="\t")
col += 1
# 这行代码的目的，就是在一行星星输出完成以后，添加换行！
print("")
i += 1
"""
import hm_函数_输出九九乘法表
hm_函数_输出九九乘法表.multiple_table()
"""
2.1 函数的定义
def 函数名():
函数封装的代码
……
1.def 是英文 define 的缩写
2.函数名称 应该能够表达 函数封装代码 的功能，方便后续的调用
3.函数名称 的命名应该 符合 标识符的命名规则
1）可以由 字母、下划线 和 数字 组成
2）不能以数字开头
3）不能与关键字重名
2.2 函数的调用
调用函数很简单的，通过 函数名() 即可完成对函数的调用
2.3 函数的文档注释
在开发中，如果希望给函数添加注释，应该在 定义函数 的下方，使用 连续的三对引号
在 连续的三对引号 之间编写对函数的说明文字
在 函数调用 位置，使用快捷键 CTRL + Q 可以查看函数的说明信息
"""
# 定义好函数以后，只表示这个函数封装了一段代码而已
def say_hello() -> object:
"""打招呼"""
print("hello 1")
# 调用函数（使用快捷键 CTRL + Q 可以查看函数的说明信息）
say_hello()
"""
3.1 函数参数的使用
在函数名的后面的小括号内部填写 参数
多个参数之间使用 , 分隔
3.2 参数的作用
函数，把 具有独立功能的代码块 组织为一个小模块，在需要的时候 调用
函数的参数，增加函数的 通用性，针对 相同的数据处理逻辑，能够 适应更多的数据
在函数 内部，把参数当做 变量 使用，进行需要的数据处理
函数调用时，按照函数定义的参数顺序，把 希望在函数内部处理的数据，通过参数 传递
3.3 形参和实参
形参：定义 函数时，小括号中的参数，是用来接收参数用的，在函数内部 作为变量使用
实参：调用 函数时，小括号中的参数，是用来把数据传递到 函数内部 用的
"""
# 对两个数字的求和
def sum_num0(p1, p2):
result = p1 + p2
print("%d + %d = %d" % (p1, p2, result))
sum_num0(2, 3)
"""
4.1 函数的返回值
在程序开发中，有时候，会希望 一个函数执行结束后，告诉调用者一个结果，以便调用者针对具体的结果做后续的处理
返回值 是函数 完成工作后，最后 给调用者的 一个结果
在函数中使用 return 关键字可以返回结果
调用函数一方，可以 使用变量 来 接收 函数的返回结果
"""
# 对两个数字的求和
# 1.第一种方式
def sum_num1(p1, p2):
return "%d" % (p1 + p2)
print("计算的结果是 %d" % float(sum_num1(2, 3)))
# 第二种方式
def sum_num2(p1, p2):
return p1 + p2
result = sum_num2(2, 3)
print("计算的结果是 %d" % result)
"""
05. 函数的嵌套调用
1.一个函数里面 又调用 了 另外一个函数，这就是 函数嵌套调用
2.如果函数 test2 中，调用了另外一个函数 test1
1)那么执行到调用 test1 函数时，会先把函数 test1 中的任务都执行完
2)才会回到 test2 中调用函数 test1 的位置，继续执行后续的代码
"""
def test1():
print("*" * 50)
print("test 1")
print("*" * 50)
def test2():
print("-" * 50)
print("test 2")
test1()
print("-" * 50)
test2()
"""
打印结果：顺序执行
--------------------------------------------------
test 2
**************************************************
test 1
**************************************************
--------------------------------------------------
"""
"""
06. 使用模块中的函数
模块是 Python 程序架构的一个核心概念
模块 就好比是 工具包，要想使用这个工具包中的工具，就需要 导入 import 这个模块
每一个以扩展名 py 结尾的 Python 源代码文件都是一个 模块
在模块中定义的 全局变量 、 函数 都是模块能够提供给外界直接使用的工具
模块名也是一个标识符
标示符可以由 字母、下划线 和 数字 组成
不能以数字开头
不能与关键字重名
"""