1.單行注釋
目前創(chuàng)新互聯(lián)公司已為成百上千家的企業(yè)提供了網(wǎng)站建設(shè)、域名、網(wǎng)站空間、網(wǎng)站運營、企業(yè)網(wǎng)站設(shè)計、殷都網(wǎng)站維護等服務,公司將堅持客戶導向、應用為本的策略,正道將秉承"和諧、參與、激情"的文化,與客戶和合作伙伴齊心協(xié)力一起成長,共同發(fā)展。
Python編程語言的單行注釋常以#開頭,單行注釋可以作為單獨的一行放在被注釋代碼行之上,也可以放在語句或者表達式之后。
實例:
# -*- coding: UTF-8 -*-
print("hello world!"); #您好,世界
2.多行注釋
Python中多行注釋使用三個單引號(’’’)或者三個雙引號(”””)來標記,而實際上這是多行字符串的書寫方式,并不是Python本身提倡的多行注釋方法。
實例:
'''
這是多行注釋,使用單引號。
這是多行注釋,使用單引號。
'''
"""
這是多行注釋,使用雙引號。
這是多行注釋,使用雙引號。
"""
我們將在本節(jié)中介紹 Python 語句,縮進以及注釋,在本節(jié)的最后一部分,還會介紹作為一種特殊類型的 Python 注釋 Docstring 。
Python 語句是給解釋器執(zhí)行的指令,一條 Python 語句包含類似于如下的表達式,
你可以將 Python 語句堪稱解釋器解釋表達式并將其結(jié)果存儲在變量中的指令。類似于 for , while , print 之類的語句具有特殊的含義,我們將在在后面的章節(jié)中討論。
當你在一句語句結(jié)束時按回車鍵后,該 Python 語句被終止,我們可稱之為單行語句。Python 中的多行語句可以通過使用連續(xù)字符 來創(chuàng)建,它將 Python 語句擴展為多行語句。
比如下面的例子,
這可以被稱作明確的多行接續(xù)。
你還可以使用括號 () ,方括號 [] 或大括號 {} 來進行隱式的多行接續(xù)。
例如,你可以使用括號來連接多行語句,
Python 語句塊,例如函數(shù),循環(huán)或類的主體,以縮進來開頭。對于語句塊內(nèi)的每個語句,應該保持相同的縮進。當縮進不一致時,你將得到什么什么 IndentationError 。
一般來說,在
Python 代碼樣式指南
中建議使用 4 個縮進空格。舉例如下,
我們用縮進來增加程序的可讀性,比如在下面的程序中,我們用兩種方式來完成同一個功能,
你可以在這里看到第一個例子比第二個例子有更好的可讀性。
注釋用于描述程序的目的或工作工程,注釋是在 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 """ .
三重引號 ''' 通??梢杂脕矶x多行文檔注釋 Docstring ,你也可以用它來作為另外一種在 Python 中添加多行注釋的方法。
Docstring 是文檔字符串,它通常是 Python 函數(shù),類,模塊等的第一條語句。函數(shù),方法和類的描述和注釋位于文檔字符串(文檔字符串)內(nèi)。
舉例如下,
一目了然, Docstring 介紹了函數(shù)的功能。
python中的注釋有單行注釋和多行注釋:
1、單行注釋(行注釋)
python中使用#表示單行注釋。單行注釋可以作為單獨的一行放在被注釋代碼行之上,也可以放在語句或表達式之后。
比如:
# 這是一個注釋
print("Hello, World!")
①當單行注釋作為單獨的一行放在被注釋代碼行之上時,為了保證代碼的可讀性,建議在#后面添加一個空格,再添加注釋內(nèi)容。
②當單行注釋放在語句或者表達式之后時,同樣為了保證代碼的可讀性,建議注釋和語句之間至少要有兩個空格。
2、多行注釋(塊注釋)
當注釋內(nèi)容過多,導致一行無法顯示時,就可以使用多行注釋。多行注釋用三個單引號'''或者三個雙引號 """將注釋括起來。
①單引號(''')
'''
這是多行注釋,用三個單引號
這是多行注釋,用三個單引號
這是多行注釋,用三個單引號
'''
print("Hello, World!")
②雙引號(""")
"""
這是多行注釋,用三個雙引號
這是多行注釋,用三個雙引號
這是多行注釋,用三個雙引號
"""
print("Hello, World!")
3、注意
①注釋不是越多越好,對于一目了然的代碼,不需要添加注釋;
②對于復雜的操作,應該在操作開始前寫上相應的注釋;
③對于不是一目了然的代碼,可以在代碼之后添加注釋;
④絕對不要描述代碼,一般閱讀代碼的人都了解python的語法,只是不知道代碼要干什么。
python代碼的注釋有兩種。
一、python單行注釋符號(#)
python中單行注釋采用#開頭,示例:#thisisacomment。
二、批量、多行注釋符號
多行注釋是用三引號,例如:輸入''''''或者"""",將要注釋的代碼插在中間。
Python由荷蘭數(shù)學和計算機科學研究學會的吉多·范羅蘇姆于1990年代初設(shè)計,作為一門叫做ABC語言的替代品。Python提供了高效的高級數(shù)據(jù)結(jié)構(gòu),還能簡單有效地面向?qū)ο缶幊獭?/p>
Python語法和動態(tài)類型,以及解釋型語言的本質(zhì),使它成為多數(shù)平臺上寫腳本和快速開發(fā)應用的編程語言,隨著版本的不斷更新和語言新功能的添加,逐漸被用于獨立的、大型項目的開發(fā)。"
函數(shù)注解是關(guān)于用戶自定義的函數(shù)的完全可選的、隨意的元數(shù)據(jù)信息。
1.無論 Python 本身或者標準庫中都沒有使用函數(shù)注解;本節(jié)只是描述了語法。第三方的項目是自由地為文檔,類型檢查,以及其它用途選擇函數(shù)注解。
2.注解是以字典形式存儲在函數(shù)的 __annotations__ 屬性中,對函數(shù)的其它部分沒有任何影響。參數(shù)注解(Parameter annotations)是定義在參數(shù)名稱的冒號后面,緊隨著一個用來表示注解的值得表達式。返回注釋(Return annotations)是定義在一個 - 后面,緊隨著一個表達式,在冒號與 - 之間。下面的示例包含一個位置參數(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