python函數(shù)注釋方法的簡單介紹
在python中如何使用注釋
python中的注釋有多種，有單行注釋，多行注釋，批量注釋，中文注釋也是常用的。
臨湘網(wǎng)站制作公司哪家好，找成都創(chuàng)新互聯(lián)公司！從網(wǎng)頁設(shè)計(jì)、網(wǎng)站建設(shè)、微信開發(fā)、APP開發(fā)、自適應(yīng)網(wǎng)站建設(shè)等網(wǎng)站項(xiàng)目制作，到程序開發(fā)，運(yùn)營維護(hù)。成都創(chuàng)新互聯(lián)公司成立于2013年到現(xiàn)在10年的時(shí)間，我們擁有了豐富的建站經(jīng)驗(yàn)和運(yùn)維經(jīng)驗(yàn)，來保證我們的工作的順利進(jìn)行。專注于網(wǎng)站建設(shè)就選成都創(chuàng)新互聯(lián)公司。
一、python單行注釋符號(#)：井號(#)常被用作單行注釋符號，在代碼中使用#時(shí)，它右邊的任何數(shù)據(jù)都會(huì)被忽略，當(dāng)做是注釋。print 1 #輸出1，#號右邊的內(nèi)容在執(zhí)行的時(shí)候是不會(huì)被輸出的。
二、批量、多行注釋符號：在python中也會(huì)有注釋有很多行的時(shí)候，這種情況下就需要批量多行注釋符了。多行注釋是用三引號''' '''包含的。
python正則表達(dá)式的注釋方法：學(xué)過正則都知道，那簡直是天書，為了提高正則的可讀性，正則表達(dá)式中提供了X(VERBOSE): 詳細(xì)模式。這個(gè)模式下正則表達(dá)式可以是多行，忽略空白字符，并可以加入注釋。
Python：
是完全面向?qū)ο蟮恼Z言。函數(shù)、模塊、數(shù)字、字符串都是對象。并且完全支持繼承、重載、派生、多繼承，有益于增強(qiáng)源代碼的復(fù)用性。Python支持重載運(yùn)算符和動(dòng)態(tài)類型。
相對于Lisp這種傳統(tǒng)的函數(shù)式編程語言，Python對函數(shù)式設(shè)計(jì)只提供了有限的支持。有兩個(gè)標(biāo)準(zhǔn)庫(functools, itertools)提供了Haskell和Standard ML中久經(jīng)考驗(yàn)的函數(shù)式程序設(shè)計(jì)工具。
Python函數(shù)注解使用有哪些注意事項(xiàng)呢？
函數(shù)注解是關(guān)于用戶自定義的函數(shù)的完全可選的、隨意的元數(shù)據(jù)信息。
1.無論 Python 本身或者標(biāo)準(zhǔn)庫中都沒有使用函數(shù)注解；本節(jié)只是描述了語法。第三方的項(xiàng)目是自由地為文檔，類型檢查，以及其它用途選擇函數(shù)注解。
2.注解是以字典形式存儲(chǔ)在函數(shù)的 __annotations__ 屬性中，對函數(shù)的其它部分沒有任何影響。參數(shù)注解（Parameter annotations）是定義在參數(shù)名稱的冒號后面，緊隨著一個(gè)用來表示注解的值得表達(dá)式。返回注釋（Return annotations）是定義在一個(gè) - 后面，緊隨著一個(gè)表達(dá)式，在冒號與 - 之間。下面的示例包含一個(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 語句和注釋
我們將在本節(jié)中介紹 Python 語句，縮進(jìn)以及注釋，在本節(jié)的最后一部分，還會(huì)介紹作為一種特殊類型的 Python 注釋 Docstring 。
Python 語句是給解釋器執(zhí)行的指令，一條 Python 語句包含類似于如下的表達(dá)式，
你可以將 Python 語句堪稱解釋器解釋表達(dá)式并將其結(jié)果存儲(chǔ)在變量中的指令。類似于 for , while , print 之類的語句具有特殊的含義，我們將在在后面的章節(jié)中討論。
當(dāng)你在一句語句結(jié)束時(shí)按回車鍵后，該 Python 語句被終止，我們可稱之為單行語句。Python 中的多行語句可以通過使用連續(xù)字符 來創(chuàng)建，它將 Python 語句擴(kuò)展為多行語句。
比如下面的例子，
這可以被稱作明確的多行接續(xù)。
你還可以使用括號 () ，方括號 [] 或大括號 {} 來進(jìn)行隱式的多行接續(xù)。
例如，你可以使用括號來連接多行語句，
Python 語句塊，例如函數(shù)，循環(huán)或類的主體，以縮進(jìn)來開頭。對于語句塊內(nèi)的每個(gè)語句，應(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 注釋以井號 # 開始
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 """ .
三重引號 ''' 通?？梢杂脕矶x多行文檔注釋 Docstring ，你也可以用它來作為另外一種在 Python 中添加多行注釋的方法。
Docstring 是文檔字符串，它通常是 Python 函數(shù)，類，模塊等的第一條語句。函數(shù)，方法和類的描述和注釋位于文檔字符串（文檔字符串）內(nèi)。
舉例如下，
一目了然， Docstring 介紹了函數(shù)的功能。
python 多行注釋
注釋是每一個(gè)程序必要的部分，也是一個(gè)好程序員的習(xí)慣，有以下3種方式：
"""注視內(nèi)容"""，這一種最強(qiáng)大;
快捷鍵Alt + 3，需要首先選中要注釋的行；
自己寫一個(gè)函數(shù)，然后把內(nèi)容丟進(jìn)去，自動(dòng)添加#。
Python教程：單行多行注釋
工具/材料
python
01
在python中使用#號表示單行注釋
02
使用""" """或''' '''做為多行注釋
03
單行注釋和多行注釋不宜過多,不是每行代表都要注釋,最好用來解釋函數(shù)的操作
04
以下是一些錯(cuò)誤使用注釋的方式,一些能直接看到結(jié)果的代碼最好不要多寫注釋
特別提示
關(guān)鍵代碼,復(fù)雜代碼使用注釋
當(dāng)前名稱：python函數(shù)注釋方法的簡單介紹
標(biāo)題來源：http://m.jiaotiyi.com/article/docgges.html