python中的注釋有單行注釋和多行注釋:
創(chuàng)新互聯專注為客戶提供全方位的互聯網綜合服務,包含不限于成都網站設計、成都網站制作、外貿網站建設、龍門網絡推廣、小程序開發(fā)、龍門網絡營銷、龍門企業(yè)策劃、龍門品牌公關、搜索引擎seo、人物專訪、企業(yè)宣傳片、企業(yè)代運營等,從售前售中售后,我們都將竭誠為您服務,您的肯定,是我們最大的嘉獎;創(chuàng)新互聯為所有大學生創(chuàng)業(yè)者提供龍門建站搭建服務,24小時服務熱線:13518219792,官方網址:www.cdcxhl.com
1、單行注釋(行注釋)
python中使用#表示單行注釋。單行注釋可以作為單獨的一行放在被注釋代碼行之上,也可以放在語句或表達式之后。
比如:
# 這是一個注釋
print("Hello, World!")
①當單行注釋作為單獨的一行放在被注釋代碼行之上時,為了保證代碼的可讀性,建議在#后面添加一個空格,再添加注釋內容。
②當單行注釋放在語句或者表達式之后時,同樣為了保證代碼的可讀性,建議注釋和語句之間至少要有兩個空格。
2、多行注釋(塊注釋)
當注釋內容過多,導致一行無法顯示時,就可以使用多行注釋。多行注釋用三個單引號'''或者三個雙引號 """將注釋括起來。
①單引號(''')
'''
這是多行注釋,用三個單引號
這是多行注釋,用三個單引號
這是多行注釋,用三個單引號
'''
print("Hello, World!")
②雙引號(""")
"""
這是多行注釋,用三個雙引號
這是多行注釋,用三個雙引號
這是多行注釋,用三個雙引號
"""
print("Hello, World!")
3、注意
①注釋不是越多越好,對于一目了然的代碼,不需要添加注釋;
②對于復雜的操作,應該在操作開始前寫上相應的注釋;
③對于不是一目了然的代碼,可以在代碼之后添加注釋;
④絕對不要描述代碼,一般閱讀代碼的人都了解python的語法,只是不知道代碼要干什么。
-:標記返回函數注釋,信息作為.__annotations__屬性提供,__annotations__屬性是字典。鍵return是用于在箭頭后檢索值的鍵。但是在Python中3.5,PEP 484 - Type Hints附加了一個含義:-用于指示函數返回的類型。它似乎也將在未來版本中強制執(zhí)行。
eg:
def test() - [1, 2, 3, 4, 5]:
pass
print(test.__annotations__)
輸出:
{'return': [1, 2, 3, 4, 5]}
4.7.7. 函數注解
函數注解 是關于用戶自定義的函數的完全可選的、隨意的元數據信息。無論 Python 本身或者標準庫中都沒有使用函數注解;本節(jié)只是描述了語法。第三方的項目是自由地為文檔,類型檢查,以及其它用途選擇函數注解。
注解是以字典形式存儲在函數的 __annotations__ 屬性中,對函數的其它部分沒有任何影響。參數注解(Parameter annotations)是定義在參數名稱的冒號后面,緊隨著一個用來表示注解的值得表達式。返回注釋(Return annotations)是定義在一個 - 后面,緊隨著一個表達式,在冒號與 - 之間。下面的示例包含一個位置參數,一個關鍵字參數,和沒有意義的返回值注釋:
def f(ham: 42, eggs: int = 'spam') - "Nothing to see here":
... print("Annotations:", f.__annotations__)
... print("Arguments:", ham, eggs)
...
f('wonderful')
Annotations: {'eggs':
, 'return': 'Nothing to see here', 'ham': 42}
Arguments: wonderful spam