四類引數

• 普通引數
• 預設引數
• 關鍵字引數
• 收集引數

關鍵字引數開始

• 語法

    def func(p1=v1, p2=v2.....):
        func_body
  
    呼叫函式：
    func(p1=value1, p2=value2.......)

• 比較麻煩，但也有好處：
  • 不容易混淆， 一般實參和形參只是按照位置一一對應即可，容易出錯
  • 使用關鍵字引數，可以不考慮引數位置

# 關鍵字引數案例
def stu(name, age, addr):
    print("I am a student")
    print("我叫 {0}， 我今年 {1}歲了， 我住{2}".format(name, age, addr))
    
    
n = "jingjing"
a = 18
addr = "我家"

# 普通引數，只按照位置傳遞，容易出錯
stu(a, n, addr)


def stu_key(name="No name", age=0, addr="No addr"):
    print("I am a student")
    print("我叫 {0}， 我今年 {1}歲了， 我住{2}".format(name, age, addr))
    
    
n = "jingjing"
a = 18
addr = "我家"

# 普通引數，只按照位置傳遞，容易出錯
stu_key(age=a, name=n, addr=addr)
 

I am a student
我叫 18， 我今年 jingjing歲了， 我住我家
I am a student
我叫 jingjing， 我今年 18歲了， 我住我家

收集引數

• 把沒有位置，不能和定義時的引數位置相對應的引數，放入一個特定的資料結構中

• 語法

    def func(*args):
        func_body
        按照list使用方式訪問args得到傳入的引數
  
    呼叫：
    func(p1, p2, p3, .....)

• 引數名args不是必須這麼寫，但是，我們推薦直接用args，約定俗成
• 引數名args前需要由星號
• 收集引數可以和其他引數共存

# 收集引數程式碼
# 函式模擬一個學生進行自我介紹，但具體內容不清楚
# args把他看做一個list
def stu( *args):
    print("Hello 大家好，我自我介紹以下，簡答說兩句：")
    # type函式作用是檢測變數的型別
    print(type(args))
    for item in args:
        print(item)


stu("liuying", 18, "北京大通州區", "wangxiaojing", "single")

stu("周大神")

Hello 大家好，我自我介紹以下，簡答說兩句：
<class 'tuple'>
liuying
18
北京大通州區
wangxiaojing
single
Hello 大家好，我自我介紹以下，簡答說兩句：
<class 'tuple'>
周大神

# 收集引數案例
# 說明收集引數可以不帶任何實參呼叫，此時收集引數為空tuple
stu()

Hello 大家好，我自我介紹以下，簡答說兩句：
<class 'tuple'>

# 如果使用關鍵字引數格式呼叫，會出現問題
stu(name="liuying")

---------------------------------------------------------------------------
TypeError                                 Traceback (most recent call last)
<ipython-input-12-b698f7b62960> in <module>()
      1 # 如果使用關鍵字引數格式呼叫，會出現問題
----> 2 stu(name="liuying")

TypeError: stu() got an unexpected keyword argument 'name'

收集引數之關鍵字收集引數

• 把關鍵字引數按字典格式存入收集引數

• 語法：

    def func( **kwargs):
        func_body
  
    # 呼叫：
    func(p1=v1, p2=v2, p3=v3........)
  

  • kwargs一般約定俗成
  • 呼叫的時候，把多餘的關鍵字引數放入kwargs
  • 訪問kwargs需要按字典格式訪問

# 收集引數案例
# 自我介紹
# 呼叫的時候需要使用關鍵字引數呼叫
def stu( **kwargs):
    # 在函式體內對於kwargs的使用不用帶星號
    print("Hello 大家好，我先自我介紹一下：")
    print(type(kwargs))
    # 對於字典的訪問，python2 和python3有區別
    for k,v in kwargs.items():
        print(k, "---", v)
    
stu(name="liuying",  age=19, addr="北京大通州區", lover="王曉靜", work="Teacher")

print("*" * 50)

stu(name="周大神")

Hello 大家好，我先自我介紹一下：
<class 'dict'>
name --- liuying
age --- 19
addr --- 北京大通州區
lover --- 王曉靜
work --- Teacher
**************************************************
Hello 大家好，我先自我介紹一下：
<class 'dict'>
name --- 周大神

# 收集引數可以為空案例
stu()

Hello 大家好，我先自我介紹一下：
<class 'dict'>

收集引數混合呼叫的順序問題

• 收集引數，關鍵字引數，普通引數可以混合使用
• 使用規則就是，普通引數和關鍵字引數優先
• 定義的時候一般找普通引數，關鍵字引數，收集引數tuple，收集引數dict

# 收集引數混合呼叫案例
# stu模擬一個學生的自我介紹
def stu(name, age, *args, hobby="沒有", **kwargs):
    print("Hello 大家好")
    print("我叫 {0}， 我今年{1}大了。".format(name, age))
    if hobby == "沒有":
        print("我沒有愛好， so sorry")
    else:
        print("我的愛好是{0}".format(hobby))
        
    print("*" * 20)   
    
    for i in args:
        print(i)
    
    print("#" * 30)
    
    for k,v in kwargs.items():
        print(k, "---", v)
        
        
# 開始呼叫函式
name = "liuying"
age = 19


# 呼叫的不同格式
stu(name, age)

stu(name, age, hobby="游泳")

stu(name, age, "王曉靜", "劉石頭", hobby="游泳", hobby2="烹飪", hobby3="跟不同女生聊天")

Hello 大家好
我叫 liuying， 我今年19大了。
我沒有愛好， so sorry
********************
##############################
Hello 大家好
我叫 liuying， 我今年19大了。
我的愛好是游泳
********************
##############################
Hello 大家好
我叫 liuying， 我今年19大了。
我的愛好是游泳
********************
王曉靜
劉石頭
##############################
hobby2 --- 烹飪
hobby3 --- 跟不同女生聊天

收集引數的解包問題

• 把引數放入list或者字典中，直接把list/dict中的值放入收集引數中
• 語法：參看案例

# 收集引數的解包問題

def stu(*args):
    print("哈哈哈哈哈")
    # n 用來表示迴圈次數
    # 主要用來除錯
    n = 0
    for i in args:
        print(type(i))
        print(n)
        n += 1
        print(i)
        
        
#stu("liuying", "liuxiaoyhing", 19, 200)

l = ["liuying", 19, 23, "wangxiaojing"]
 
#stu(l)
# 此時，args的表示形式是字典內一個list型別的元素，即 arg = (["liuying", 19, 23, "wangxiaojing"],)
# 很顯然跟我們最初的想法違背


# 此時的呼叫，我們就需要解包符號，即呼叫的時候前面加一個星號
stu(*l)

哈哈哈哈哈
<class 'str'>
0
liuying
<class 'int'>
1
19
<class 'int'>
2
23
<class 'str'>
3
wangxiaojing

同理，dict型別收集引數一樣可以解包，但是

• 對dict型別進行解包
• 需要用兩個星號進行解包

返回值

• 函式和過程的區別
  • 有無返回值
• 需要用return顯示返回內容，
• 如果沒有返回，則預設返回None
• 推薦寫法，無論有無返回值，最後都要以return 結束

# 返回值示例

def func_1():
    print("有返回值呀")
    return 1

def func_2():
    print("沒有返回值")
     
    
f1 = func_1()
print(f1)

f2 = func_2()
print(f2)

有返回值呀
1
沒有返回值
None

函式文件

• 函式的文件的作用是對當前函式提供使用相關的參考資訊
• 文件的寫法：
  • 在函式內部開始的第一行使用三引號字串定義符
  • 一般具有特定格式
  • 參看案例
• 文件檢視
  • 使用help函式，形如 help(func)
  • 使用doc, 參看案例

# 文件案例
# 函式stu是模擬一個學生的自我介紹的內容
def stu(name, age, *args):
    '''
    這是第一行
    這是第二行
    這是第三行
    '''
    print("This is hanshu stu")

# 檢視函式文件
help(stu)
stu.__doc__
Help on function stu in module __main__:

stu(name, age, *args)
    這是第一行
    這是第二行
    這是第三行

'\n    這是第一行\n    這是第二行\n    這是第三行\n    '

def stu(name, age):
    '''
    這是文件的文字內容
    :param name: 表示學生的姓名
    :param age: 表示學生的年齡
    :return: 此函式沒有返回值
    '''
    pass


print(help(stu))

print("*" * 20)

print(stu.__doc__)
Help on function stu in module __main__:

stu(name, age)
    這是文件的文字內容
    :param name: 表示學生的姓名
    :param age: 表示學生的年齡
    :return: 此函式沒有返回值

None
********************

    這是文件的文字內容
    :param name: 表示學生的姓名
    :param age: 表示學生的年齡
    :return: 此函式沒有返回值