使用Python3內(nèi)置文檔高效學(xué)習(xí)以及官方中文文檔
概述
從前面的對Python基礎(chǔ)知識方法介紹中,我們幾乎是圍繞Python內(nèi)置方法進行探索實踐,比如字符串、列表、字典等數(shù)據(jù)結(jié)構(gòu)的內(nèi)置方法,和大量內(nèi)置的標(biāo)準(zhǔn)庫,諸如functools、time、threading等等,而我們怎么快速學(xué)習(xí)掌握并學(xué)會使用這個Python的工具集呢? 我們可以利用Python的內(nèi)置文檔大量資源既可以掌握許多關(guān)于Python工具集的基本使用。
dir函數(shù)
Python中內(nèi)置的dir函數(shù)用于提取某對象內(nèi)所有屬性的方法,,諸如對象的方法及屬性
L = [1, 2, 3, 4] print(dir(L)) print([])
示例結(jié)果:
['__add__', '__class__', '__contains__', '__delattr__', '__delitem__', '__delslice__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__getitem__', '__getslice__', '__gt__', '__hash__', '__iadd__', '__imul__', '__init__', '__iter__', '__le__', '__len__', '__lt__', '__mul__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__reversed__', '__rmul__', '__setattr__', '__setitem__', '__setslice__', '__sizeof__', '__str__', '__subclasshook__', 'append', 'count', 'extend', 'index', 'insert', 'pop', 'remove', 'reverse', 'sort']
['__add__', '__class__', '__contains__', '__delattr__', '__delitem__', '__delslice__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__getitem__', '__getslice__', '__gt__', '__hash__', '__iadd__', '__imul__', '__init__', '__iter__', '__le__', '__len__', '__lt__', '__mul__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__reversed__', '__rmul__', '__setattr__', '__setitem__', '__setslice__', '__sizeof__', '__str__', '__subclasshook__', 'append', 'count', 'extend', 'index', 'insert', 'pop', 'remove', 'reverse', 'sort']
可以看到我們可以傳入某實例對象查看其屬性,也可以直接傳入其內(nèi)置類型的空對象查看對應(yīng)屬性,我們甚至還可以直接傳入類型的名稱得到對應(yīng)的屬性列表:
print(dir(list))
示例結(jié)果:
['__add__', '__class__', '__contains__', '__delattr__', '__delitem__', '__delslice__', '__doc__', '__eq__', '__format__', '__ge__', '__getattribute__', '__getitem__', '__getslice__', '__gt__', '__hash__', '__iadd__', '__imul__', '__init__', '__iter__', '__le__', '__len__', '__lt__', '__mul__', '__ne__', '__new__', '__reduce__', '__reduce_ex__', '__repr__', '__reversed__', '__rmul__', '__setattr__', '__setitem__', '__setslice__', '__sizeof__', '__str__', '__subclasshook__', 'append', 'count', 'extend', 'index', 'insert', 'pop', 'remove', 'reverse', 'sort']
雖然我們獲得了對象的屬性,但我們?nèi)匀徊恢肋@些屬性方法的含義,那么我們可以利用文檔字符串幫助我們繼續(xù)學(xué)習(xí)對象屬性。
文檔字符串:doc
文檔字符串是由Python自動生成的,而生成的內(nèi)內(nèi)容和位置取決于我們的放置方式,文檔字符串也是一段注釋,放在模塊文件、函數(shù)以及類語句的頂端,然后Python會自動封裝這個字符串,即成為所謂的文檔字符串,通過對象的__doc__進行查看。
def two_sum(x, y): ''' Used to calculate the sum of two numbers ''' return x + y print(two_sum.__doc__)
示例結(jié)果:
Used to calculate the sum of two numbers
以上示例就實現(xiàn)了對一個函數(shù)(用于計算兩數(shù)之和)綁定文檔字符串并查看其文檔字符串的過程。我們也可以查看一些內(nèi)置類型的某屬性的具體使用方法,比如查看列表對象中pop的具體含義和用法
L = [1, 2, 3, 4] print(L.pop.__doc__)
示例結(jié)果:
L.pop([index]) -> item -- remove and return item at index (default last).
Raises IndexError if list is empty or index is out of range.
PyDoc:help函數(shù)
我們可以利用Python中help函數(shù)工具更加友好結(jié)構(gòu)化的展示對象的文檔字符串和其他的信息,對于對于某些較大的對象help內(nèi)容會分成幾段,甚至可以進行交互展示對象的詳細(xì)信息。
help(list)
交互結(jié)果:
Help on class list in module __builtin__:
class list(object)
| list() -> new empty list
| list(iterable) -> new list initialized from iterable's items
|
| Methods defined here:
|
| __add__(...)
| x.__add__(y) <==> x+y
|
| __contains__(...)
| x.__contains__(y) <==> y in x
|
| __delitem__(...)
| x.__delitem__(y) <==> del x[y]
|
| __delslice__(...)
| x.__delslice__(i, j) <==> del x[i:j]
|
-- More --
比如我們可以通過help查看列表的所有詳細(xì)信息和屬性的用法等,通過回車鍵查看更多的信息。
官方中文文檔
對于英文閱讀有一定困難的小伙伴,新出Python官方中文文檔是較好的學(xué)習(xí)體驗教程:docs.python.org/zh-cn/3/,從入門教程,標(biāo)準(zhǔn)庫,在到Python高級特性應(yīng)有盡有,算是不錯的學(xué)習(xí)資源和一本常用的**“Python字典”**。
總結(jié)
以上就是這篇文章的全部內(nèi)容了,希望本文的內(nèi)容對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,謝謝大家對腳本之家的支持。
相關(guān)文章
python進行debug操作實戰(zhàn)訓(xùn)練
debug是編碼是非常重要的調(diào)試技巧,通過在運行過程中設(shè)置斷點,幫助開發(fā)人員更好的理解運行過程,下面這篇文章主要給大家介紹了關(guān)于python進行debug操作的相關(guān)資料,需要的朋友可以參考下2023-06-06用Python編寫生成樹狀結(jié)構(gòu)的文件目錄的腳本的教程
這篇文章主要介紹了用Python編寫生成樹狀結(jié)構(gòu)的文件目錄的腳本的教程,是一個利用os模塊下各函數(shù)的簡單實現(xiàn),需要的朋友可以參考下2015-05-05基于Python Numpy的數(shù)組array和矩陣matrix詳解
下面小編就為大家分享一篇基于Python Numpy的數(shù)組array和矩陣matrix詳解,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-04-04Python實現(xiàn)計算兩個時間之間相差天數(shù)的方法
這篇文章主要介紹了Python實現(xiàn)計算兩個時間之間相差天數(shù)的方法,涉及Python針對日期時間的相關(guān)運算操作技巧,需要的朋友可以參考下2017-05-05Python?中strip()函數(shù)詳細(xì)說明及使用方法
strip()函數(shù)是Python字符串方法之一,用于處理字符串的前導(dǎo)和尾隨空白字符,它返回一個新字符串,該字符串是原始字符串去除前導(dǎo)和尾隨空格(包括空格、制表符、換行符等)后的結(jié)果,這篇文章主要介紹了Python?中strip()函數(shù)詳細(xì)說明及使用方法,需要的朋友可以參考下2024-02-02