怎樣閱讀Python官方文檔

怎樣閱讀Python官方文檔

對于初學者來講吕世,由于沒有相關(guān)的經(jīng)驗翻翩,學習語言的時候檐盟,往往耗時耗力而且效果不太好褂萧,這里簡單講下如何閱讀官方文檔,一旦學會快速查詢官方文檔葵萎,學習的效率會提升很多
文檔傳送門

homepage.png

如何閱讀API文檔

API這里特指Python標準庫文檔导犹,所謂標準庫就是Python本身自帶的庫,區(qū)別于第三方庫羡忘,不需要額外的下載其他東西就能直接使用谎痢,提供最基本最核心的功能,離開了這些庫可以說是寸步難行卷雕。

標準庫里面內(nèi)容那么多节猿,如何快速找到自己想要的東西。

第一種方式概覽
index.png

先查找索引漫雕,采用從整體到局部的瀏覽方法滨嘱,而不是從上到下的瀏覽方式:例如我想讀取一個txt文件,比較好的查詢方式是

瀏覽目錄 --------> File and Directory Access -----> pathlib — Object-oriented filesystem paths
                     

而不是從上至下逐一瀏覽,采用分類查詢的方法快速查詢, 讀取txt浸间,你首先想到的是這是一種文件訪問太雨,那么對應(yīng)應(yīng)該在該分類去找,當然仍然需要一定的經(jīng)驗去定位你的需求處于哪個分類魁蒜。

第一種方式精確查找

前一種方式適用于躺彬,你只知道大概的范圍的情況下查找想要的API,這種方式則是你已經(jīng)知道具體要使用哪個module的情況梅惯。

  • search 關(guān)鍵字


    search.png
  • 找到最符合的查詢結(jié)果


    search_result.png

如何閱讀API 細節(jié)

Built-in Functions 為例

build_functions_index.png

最前面仍然是索引宪拥,絕大部分的API都是這樣,最開始的部分永遠是介紹這個module是用來干嘛铣减,具備哪些功能她君,接著配上索引.

以abs為例

點解我畫紅線的部分即可跳轉(zhuǎn)至指定函數(shù)的詳細講解


abs_and_all.png
  • abs 函數(shù)沒有demo,我補一個
litengfangdeMacBook-Pro:~ litengfang$ python3
Python 3.7.2 (v3.7.2:9a3ffc0492, Dec 24 2018, 02:44:43) 
[Clang 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> abs(-5)
5

當然有的時候我們看了函數(shù)的介紹還是不太懂葫哗,那么寫個小demo試一下也是可以的

>>> all([1,2,3,None])
False
>>> all([1,2,3])
True

當然看完文檔還是不懂的這種情況也是常有缔刹,這個時候可能就需要求助于搜索引擎了球涛。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市校镐,隨后出現(xiàn)的幾起案子亿扁,更是在濱河造成了極大的恐慌,老刑警劉巖鸟廓,帶你破解...
    沈念sama閱讀 217,406評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件从祝,死亡現(xiàn)場離奇詭異,居然都是意外死亡引谜,警方通過查閱死者的電腦和手機牍陌,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,732評論 3 393
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來员咽,“玉大人毒涧,你說我怎么就攤上這事”词遥” “怎么了契讲?”我有些...
    開封第一講書人閱讀 163,711評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長滑频。 經(jīng)常有香客問我怀泊,道長,這世上最難降的妖魔是什么误趴? 我笑而不...
    開封第一講書人閱讀 58,380評論 1 293
  • 正文 為了忘掉前任,我火速辦了婚禮务傲,結(jié)果婚禮上凉当,老公的妹妹穿的比我還像新娘。我一直安慰自己售葡,他們只是感情好看杭,可當我...
    茶點故事閱讀 67,432評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著挟伙,像睡著了一般楼雹。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上尖阔,一...
    開封第一講書人閱讀 51,301評論 1 301
  • 那天贮缅,我揣著相機與錄音,去河邊找鬼介却。 笑死谴供,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的齿坷。 我是一名探鬼主播桂肌,決...
    沈念sama閱讀 40,145評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼数焊,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了崎场?” 一聲冷哼從身側(cè)響起佩耳,我...
    開封第一講書人閱讀 39,008評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎谭跨,沒想到半個月后干厚,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,443評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡饺蚊,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,649評論 3 334
  • 正文 我和宋清朗相戀三年萍诱,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片污呼。...
    茶點故事閱讀 39,795評論 1 347
  • 序言:一個原本活蹦亂跳的男人離奇死亡裕坊,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出燕酷,到底是詐尸還是另有隱情籍凝,我是刑警寧澤,帶...
    沈念sama閱讀 35,501評論 5 345
  • 正文 年R本政府宣布苗缩,位于F島的核電站饵蒂,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏酱讶。R本人自食惡果不足惜退盯,卻給世界環(huán)境...
    茶點故事閱讀 41,119評論 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望泻肯。 院中可真熱鬧渊迁,春花似錦、人聲如沸灶挟。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,731評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽稚铣。三九已至箱叁,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間惕医,已是汗流浹背耕漱。 一陣腳步聲響...
    開封第一講書人閱讀 32,865評論 1 269
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留抬伺,地道東北人孤个。 一個月前我還...
    沈念sama閱讀 47,899評論 2 370
  • 正文 我出身青樓,卻偏偏與公主長得像沛简,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 44,724評論 2 354

推薦閱讀更多精彩內(nèi)容