我們將在本節(jié)中介紹 Python 語(yǔ)句,縮進(jìn)以及注釋,在本節(jié)的最后一部分,還會(huì)介紹作為一種特殊類型的 Python 注釋 Docstring 。
成都創(chuàng)新互聯(lián)是一家集網(wǎng)站建設(shè),元江縣企業(yè)網(wǎng)站建設(shè),元江縣品牌網(wǎng)站建設(shè),網(wǎng)站定制,元江縣網(wǎng)站建設(shè)報(bào)價(jià),網(wǎng)絡(luò)營(yíng)銷,網(wǎng)絡(luò)優(yōu)化,元江縣網(wǎng)站推廣為一體的創(chuàng)新建站企業(yè),幫助傳統(tǒng)企業(yè)提升企業(yè)形象加強(qiáng)企業(yè)競(jìng)爭(zhēng)力。可充分滿足這一群體相比中小企業(yè)更為豐富、高端、多元的互聯(lián)網(wǎng)需求。同時(shí)我們時(shí)刻保持專業(yè)、時(shí)尚、前沿,時(shí)刻以成就客戶成長(zhǎng)自我,堅(jiān)持不斷學(xué)習(xí)、思考、沉淀、凈化自己,讓我們?yōu)楦嗟钠髽I(yè)打造出實(shí)用型網(wǎng)站。
Python 語(yǔ)句是給解釋器執(zhí)行的指令,一條 Python 語(yǔ)句包含類似于如下的表達(dá)式,
你可以將 Python 語(yǔ)句堪稱解釋器解釋表達(dá)式并將其結(jié)果存儲(chǔ)在變量中的指令。類似于 for , while , print 之類的語(yǔ)句具有特殊的含義,我們將在在后面的章節(jié)中討論。
當(dāng)你在一句語(yǔ)句結(jié)束時(shí)按回車鍵后,該 Python 語(yǔ)句被終止,我們可稱之為單行語(yǔ)句。Python 中的多行語(yǔ)句可以通過使用連續(xù)字符 來創(chuàng)建,它將 Python 語(yǔ)句擴(kuò)展為多行語(yǔ)句。
比如下面的例子,
這可以被稱作明確的多行接續(xù)。
你還可以使用括號(hào) () ,方括號(hào) [] 或大括號(hào) {} 來進(jìn)行隱式的多行接續(xù)。
例如,你可以使用括號(hào)來連接多行語(yǔ)句,
Python 語(yǔ)句塊,例如函數(shù),循環(huán)或類的主體,以縮進(jìn)來開頭。對(duì)于語(yǔ)句塊內(nèi)的每個(gè)語(yǔ)句,應(yīng)該保持相同的縮進(jìn)。當(dāng)縮進(jìn)不一致時(shí),你將得到什么什么 IndentationError 。
一般來說,在
Python 代碼樣式指南
中建議使用 4 個(gè)縮進(jìn)空格。舉例如下,
我們用縮進(jìn)來增加程序的可讀性,比如在下面的程序中,我們用兩種方式來完成同一個(gè)功能,
你可以在這里看到第一個(gè)例子比第二個(gè)例子有更好的可讀性。
注釋用于描述程序的目的或工作工程,注釋是在 Python 解釋過程中被忽略的行為,它們不會(huì)干擾程序的流程。
如果你正在編寫數(shù)百行代碼,肯定需要添加注釋,因?yàn)槠渌嗽陂喿x你的代碼的時(shí)候,沒有足夠的時(shí)間閱讀每一行來理解代碼的工作。程序的注釋增加了可讀性,并解釋了代碼的工作原理。
Python 注釋以井號(hào) # 開始
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 """ .
三重引號(hào) ''' 通常可以用來定義多行文檔注釋 Docstring ,你也可以用它來作為另外一種在 Python 中添加多行注釋的方法。
Docstring 是文檔字符串,它通常是 Python 函數(shù),類,模塊等的第一條語(yǔ)句。函數(shù),方法和類的描述和注釋位于文檔字符串(文檔字符串)內(nèi)。
舉例如下,
一目了然, Docstring 介紹了函數(shù)的功能。
函數(shù)注解是關(guān)于用戶自定義的函數(shù)的完全可選的、隨意的元數(shù)據(jù)信息。
1.無論 Python 本身或者標(biāo)準(zhǔn)庫(kù)中都沒有使用函數(shù)注解;本節(jié)只是描述了語(yǔ)法。第三方的項(xiàng)目是自由地為文檔,類型檢查,以及其它用途選擇函數(shù)注解。
2.注解是以字典形式存儲(chǔ)在函數(shù)的 __annotations__ 屬性中,對(duì)函數(shù)的其它部分沒有任何影響。參數(shù)注解(Parameter annotations)是定義在參數(shù)名稱的冒號(hào)后面,緊隨著一個(gè)用來表示注解的值得表達(dá)式。返回注釋(Return annotations)是定義在一個(gè) - 后面,緊隨著一個(gè)表達(dá)式,在冒號(hào)與 - 之間。下面的示例包含一個(gè)位置參數(shù),一個(gè)關(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
python中的注釋有單行注釋和多行注釋:
1、單行注釋(行注釋)
python中使用#表示單行注釋。單行注釋可以作為單獨(dú)的一行放在被注釋代碼行之上,也可以放在語(yǔ)句或表達(dá)式之后。
比如:
# 這是一個(gè)注釋
print("Hello, World!")
①當(dāng)單行注釋作為單獨(dú)的一行放在被注釋代碼行之上時(shí),為了保證代碼的可讀性,建議在#后面添加一個(gè)空格,再添加注釋內(nèi)容。
②當(dāng)單行注釋放在語(yǔ)句或者表達(dá)式之后時(shí),同樣為了保證代碼的可讀性,建議注釋和語(yǔ)句之間至少要有兩個(gè)空格。
2、多行注釋(塊注釋)
當(dāng)注釋內(nèi)容過多,導(dǎo)致一行無法顯示時(shí),就可以使用多行注釋。多行注釋用三個(gè)單引號(hào)'''或者三個(gè)雙引號(hào) """將注釋括起來。
①單引號(hào)(''')
'''
這是多行注釋,用三個(gè)單引號(hào)
這是多行注釋,用三個(gè)單引號(hào)
這是多行注釋,用三個(gè)單引號(hào)
'''
print("Hello, World!")
②雙引號(hào)(""")
"""
這是多行注釋,用三個(gè)雙引號(hào)
這是多行注釋,用三個(gè)雙引號(hào)
這是多行注釋,用三個(gè)雙引號(hào)
"""
print("Hello, World!")
3、注意
①注釋不是越多越好,對(duì)于一目了然的代碼,不需要添加注釋;
②對(duì)于復(fù)雜的操作,應(yīng)該在操作開始前寫上相應(yīng)的注釋;
③對(duì)于不是一目了然的代碼,可以在代碼之后添加注釋;
④絕對(duì)不要描述代碼,一般閱讀代碼的人都了解python的語(yǔ)法,只是不知道代碼要干什么。
標(biāo)題名稱:python函數(shù)含注釋的簡(jiǎn)單介紹
標(biāo)題URL:http://jinyejixie.com/article38/dodphsp.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供品牌網(wǎng)站制作、移動(dòng)網(wǎng)站建設(shè)、企業(yè)網(wǎng)站制作、網(wǎng)站策劃、網(wǎng)站設(shè)計(jì)、響應(yīng)式網(wǎng)站
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請(qǐng)盡快告知,我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場(chǎng),如需處理請(qǐng)聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來源: 創(chuàng)新互聯(lián)