python函数注释,参数后面加冒号:,函数后面的箭头→是什么?
生活随笔
收集整理的這篇文章主要介紹了
python函数注释,参数后面加冒号:,函数后面的箭头→是什么?
小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.
python的函數(shù)注釋:
def f(text:str,max_len:'int>0'=80) ->str:"""這個是函數(shù)的幫助說明文檔,help時會顯示"""return True """ 函數(shù)聲明中,text:str text 是參數(shù) :冒號后面 str是參數(shù)的注釋。 如果參數(shù)有默認值,還要給注釋,如下寫。 max_len:'int>0'=80->str 是函數(shù)返回值的注釋。這些注釋信息都是函數(shù)的元信息,保存在f.__annotations__字典中、需要注意,python對注釋信息和f.__annotations__的一致性,不做檢查 不做檢查,不做強制,不做驗證!什么都不做。 """函數(shù)注釋示例:
''' 遇到問題沒人解答?小編創(chuàng)建了一個Python學習交流QQ群:579817333 尋找有志同道合的小伙伴,互幫互助,群里還有不錯的視頻學習教程和PDF電子書! ''' def f(ham: 42, eggs: int = 'spam') -> "Nothing to see here":print("函數(shù)注釋", f.__annotations__)print("參數(shù)值打印", ham, eggs)print(type(ham),type(eggs))f("www")返回信息:
函數(shù)注釋 {'ham': 42, 'eggs': <class 'int'>, 'return': 'Nothing to see here'} 參數(shù)值打印 www spam <class 'str'> <class 'str'>解釋說明:
注釋的一般規(guī)則是參數(shù)名后跟一個冒號(:),然后再跟一個expression,這個expression可以是任何形式。返回值的形式是 -> int,annotation可被保存為函數(shù)的attributes。以上屬于靜態(tài)注釋,還有一種方法叫做動態(tài)注釋
動態(tài)注釋的原理,就是在函數(shù)中或者裝飾器中動態(tài)的增加 刪除 更改 注釋內(nèi)容
f.__annotations__ 是一個字典,可以使用字典的所有操作,這樣就可以動態(tài)的更改注釋了大多數(shù)情況,我使用的是一下方法,進行注釋說明
''' 遇到問題沒人解答?小編創(chuàng)建了一個Python學習交流QQ群:579817333 尋找有志同道合的小伙伴,互幫互助,群里還有不錯的視頻學習教程和PDF電子書! ''' def foo():""" This is function foo"""Google風格 """ This is a groups style docs.Parameters:param1 - this is the first paramparam2 - this is a second paramReturns:This is a description of what is returnedRaises:KeyError - raises an exception """
Rest風格 """ This is a reST style.:param param1: this is a first param :param param2: this is a second param :returns: this is a description of what is returned :raises keyError: raises an exception """
總結(jié)
以上是生活随笔為你收集整理的python函数注释,参数后面加冒号:,函数后面的箭头→是什么?的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Python:数据编码与处理
- 下一篇: python logging模块写入中文