4.7.7. 函數(shù)注解

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