4.7.7. 函數注解
成都創新互聯公司2013年開創至今,是專業互聯網技術服務公司,擁有項目網站設計、做網站網站策劃,項目實施與項目整合能力。我們以讓每一個夢想脫穎而出為使命,1280元延吉做網站,已為上家服務,為延吉各地企業和個人服務,聯系電話:13518219792
函數注解 是關于用戶自定義的函數的完全可選的、隨意的元數據信息。無論 Python 本身或者標準庫中都沒有使用函數注解;本節只是描述了語法。第三方的項目是自由地為文檔,類型檢查,以及其它用途選擇函數注解。
注解是以字典形式存儲在函數的 __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
我們將在本節中介紹 Python 語句,縮進以及注釋,在本節的最后一部分,還會介紹作為一種特殊類型的 Python 注釋 Docstring 。
Python 語句是給解釋器執行的指令,一條 Python 語句包含類似于如下的表達式,
你可以將 Python 語句堪稱解釋器解釋表達式并將其結果存儲在變量中的指令。類似于 for , while , print 之類的語句具有特殊的含義,我們將在在后面的章節中討論。
當你在一句語句結束時按回車鍵后,該 Python 語句被終止,我們可稱之為單行語句。Python 中的多行語句可以通過使用連續字符 來創建,它將 Python 語句擴展為多行語句。
比如下面的例子,
這可以被稱作明確的多行接續。
你還可以使用括號 () ,方括號 [] 或大括號 {} 來進行隱式的多行接續。
例如,你可以使用括號來連接多行語句,
Python 語句塊,例如函數,循環或類的主體,以縮進來開頭。對于語句塊內的每個語句,應該保持相同的縮進。當縮進不一致時,你將得到什么什么 IndentationError 。
一般來說,在
Python 代碼樣式指南
中建議使用 4 個縮進空格。舉例如下,
我們用縮進來增加程序的可讀性,比如在下面的程序中,我們用兩種方式來完成同一個功能,
你可以在這里看到第一個例子比第二個例子有更好的可讀性。
注釋用于描述程序的目的或工作工程,注釋是在 Python 解釋過程中被忽略的行為,它們不會干擾程序的流程。
如果你正在編寫數百行代碼,肯定需要添加注釋,因為其他人在閱讀你的代碼的時候,沒有足夠的時間閱讀每一行來理解代碼的工作。程序的注釋增加了可讀性,并解釋了代碼的工作原理。
Python 注釋以井號 # 開始
Using hash symbol in each line can define a multi-line comment. But there is another way to add a multi-line comment in Python, that is using triple quotation marks. You can use either ''' or """ .
三重引號 ''' 通常可以用來定義多行文檔注釋 Docstring ,你也可以用它來作為另外一種在 Python 中添加多行注釋的方法。
Docstring 是文檔字符串,它通常是 Python 函數,類,模塊等的第一條語句。函數,方法和類的描述和注釋位于文檔字符串(文檔字符串)內。
舉例如下,
一目了然, Docstring 介紹了函數的功能。
使用井號加一個空格,后面的內容會被當做注釋來解析;
使用三個單引號或雙引號包裹的內容,會被當做注釋來解析,這種寫法如果放在print中,可以實現所見即所得的效果,既回車也會直接顯示在控制臺
這些基礎入門的知識,你可以到黑馬程序員社區了解一下。或者官網對話框可直接咨詢。
在二維坐標圖中我們經常對繪制的圖形進行標注。在 matplotlib 中比較常用的有text和annotate兩種標注方法,其中:
參數說明:
示例
運行結果:
Matplotlib中的annotate函數可用于在圖形上給數據添加文本注解,而且支持帶箭頭的劃線工具,非常方便我們在合適的位置添加描述信息。
參數說明:
plt.annotate() 示例
運行結果:
python中的注釋有多種,有單行注釋,多行注釋,批量注釋,中文注釋也是常用的。
一、python單行注釋符號(#):井號(#)常被用作單行注釋符號,在代碼中使用#時,它右邊的任何數據都會被忽略,當做是注釋。print 1 #輸出1,#號右邊的內容在執行的時候是不會被輸出的。
二、批量、多行注釋符號:在python中也會有注釋有很多行的時候,這種情況下就需要批量多行注釋符了。多行注釋是用三引號''' '''包含的。
python正則表達式的注釋方法:學過正則都知道,那簡直是天書,為了提高正則的可讀性,正則表達式中提供了X(VERBOSE): 詳細模式。這個模式下正則表達式可以是多行,忽略空白字符,并可以加入注釋。
Python
是完全面向對象的語言。函數、模塊、數字、字符串都是對象。并且完全支持繼承、重載、派生、多繼承,有益于增強源代碼的復用性。Python支持重載運算符和動態類型。相對于Lisp這種傳統的函數式編程語言,Python對函數式設計只提供了有限的支持。有兩個標準庫(functools, itertools)提供了Haskell和Standard ML中久經考驗的函數式程序設計工具。
1.單行注釋
Python編程語言的單行注釋常以#開頭,單行注釋可以作為單獨的一行放在被注釋代碼行之上,也可以放在語句或者表達式之后。
實例:
# -*- coding: UTF-8 -*-
print("hello world!"); #您好,世界
2.多行注釋
Python中多行注釋使用三個單引號(’’’)或者三個雙引號(”””)來標記,而實際上這是多行字符串的書寫方式,并不是Python本身提倡的多行注釋方法。
實例:
'''
這是多行注釋,使用單引號。
這是多行注釋,使用單引號。
'''
"""
這是多行注釋,使用雙引號。
這是多行注釋,使用雙引號。
"""
網站欄目:關于python顯示函數注釋的信息
URL標題:http://vcdvsql.cn/article16/hshgdg.html
成都網站建設公司_創新互聯,為您提供做網站、外貿網站建設、虛擬主機、網站設計、服務器托管、App開發
聲明:本網站發布的內容(圖片、視頻和文字)以用戶投稿、用戶轉載內容為主,如果涉及侵權請盡快告知,我們將會在第一時間刪除。文章觀點不代表本網站立場,如需處理請聯系客服。電話:028-86922220;郵箱:631063699@qq.com。內容未經允許不得轉載,或轉載時需注明來源: 創新互聯