Python 3内蔵ドキュメントリソースによる効率的な学習と公式中国語ドキュメント

6051 ワード

概要
前のPythonの基礎知識の方法の紹介から、私達はほとんどPythonの内蔵方法をめぐって探求の実践を行って、例えば文字列、リスト、辞書などのデータ構造の内蔵方法と大量の内蔵の標準ライブラリ、例えばfunctoolstimethreadingなど、私達はどのように急速に学習してこのPythonのツールセットを使うことをマスターしますか?Pythonの内蔵ドキュメントを利用して、Pythonツールセットの基本的な使用を把握することができます.
dir関数
Pythonに組み込まれているdir関数は、オブジェクトのメソッドやプロパティなど、オブジェクト内のすべてのプロパティを抽出する方法です.
L = [1, 2, 3, 4]
print(dir(L))
print([])

サンプル結果:
['__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']

インスタンスオブジェクトに転送してプロパティを表示するか、組み込みタイプの空のオブジェクトに直接転送してプロパティを表示するか、直接転送タイプの名前に対応するプロパティのリストを表示することもできます.
print(dir(list))

サンプル結果:
['__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']

オブジェクトのプロパティを取得しましたが、これらのプロパティメソッドの意味がまだ分かりません.ドキュメント文字列を使用して、オブジェクトのプロパティを学習し続けることができます.
ドキュメント文字列:doc
ドキュメント文字列はPythonによって自動的に生成され、生成された内部内容と位置は私たちの配置方法に依存し、ドキュメント文字列も注釈であり、モジュールファイル、関数、クラス文の先端に配置され、Pythonはこの文字列を自動的にカプセル化し、いわゆるドキュメント文字列となり、オブジェクトの__doc__で表示されます.
def two_sum(x, y):
    '''
    Used to calculate the sum of two numbers
    '''
    return x + y


print(two_sum.__doc__)

サンプル結果:
Used to calculate the sum of two numbers

上記の例では、1つの関数(2つの数の合計を計算するために使用される)に対してドキュメント文字列をバインドし、ドキュメント文字列を表示するプロセスを実装しました.リスト・オブジェクトのpopの具体的な意味と使用方法を表示するなど、組み込みタイプの属性の具体的な使用方法も表示できます.
L = [1, 2, 3, 4]
print(L.pop.__doc__)

サンプル結果:
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関数
Pythonのhelp関数ツールを使用すると、より友好的に構造化された展示オブジェクトのドキュメント文字列やその他の情報を使用することができ、いくつかの大きなオブジェクトについてhelpコンテンツがいくつかのセグメントに分かれ、インタラクティブに展示オブジェクトの詳細を表示することもできます.
help(list)

インタラクティブな結果:
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でリストのすべての詳細やプロパティの使い方などを表示したり、リターンキーで詳細を表示したりすることができます.
公式中国語ドキュメント
英語を読むのが難しいパートナーにとって、Pythonの公式中国語ドキュメントを新しく出すのは良い学習体験チュートリアルです.https://docs.python.org/zh-cn/3/、入門チュートリアル、標準ライブラリから、Pythonの高度な特性まで、良い学習リソースとよく使われる**「Python辞書」**です.