# Python函数是“一等公民”，这意味着可以像对待其他任何对象一样对待它们。
# 所有的函数都返回值。如果你没有告诉它们该返回什么，将返回None。
def func1():
    """\
    文档字符串，文档字符串旨在为函数、类和模块（特别是公共的函数、类和模块）提供文档。
    可以使用任何字符串字面量作为文档字符串，但标准是只使用三重引号
    """
    print("ok")


# 要判断某个对象是否可调用，可使用内置函数callable
if callable(func1):
    func1()  # ok

print(func1.__doc__)  # func 的文档字符串

# 在交互式解释器中使用 help() 函数来获取其他函数的信息
# >>> help(func)
# Help on module func:

# NAME
#     func

# FUNCTIONS
#     func()
#         func的文档字符串

# FILE
#     e:\mycode\python\func.py


# 使用默认参数
# 默认参数值只在函数定义时计算一次。使用任何可变的数据类型（如列表）作为可选参数是一件非常危险的事情。
def func2(a, b, c=3, d=4):
    return a + b + c + d


# 必须先指定所有的位置参数，再使用关键字参数
print(func2(1, 2, 3, 4))  # 10
print(func2(1, 2))  # 10

# 关键字参数的顺序不重要
# 使用关键字参数和默认参数，可以简化函数的调用
print(func2(b=1, a=2))  # 10
print(func2(b=1, a=2, d=3))  # 9


# def func(a, c=3, b, d=4):   #异常，默认参数必须在最后
#  return a+b+c+d


# 当 Python 首次处理函数定义时，将计算默认参数值 [1, 1]，并在内存中创建一个可变列表[1,1]。
# 在进行第一次函数调用时对其进行操作，然后返回。
def fibonacci_next(series=[1, 1]):
    series.append(series[-1] + series[-2])
    return series


# fib1 现在被绑定到与 series 相同的可变值，因此对 fib1 的任何更改都会反映在每次函数调用的默认参数值中。
# 最佳实践是不要使用可变值作为默认参数值
fib1 = fibonacci_next()
print(fib1)  # [1, 1, 2]
fib1 = fibonacci_next()
print(fib1)  # [1, 1, 2, 3]


# 使用 Node 作为默认值
def fibonacci_next2(series=None):
    if series is None:
        series = [1, 1]
    series.append(series[-1] + series[-2])
    return series