「ドキュメントストリング」は、
コメントの一つで、
「三重クォート("""...""")」で記述したコメントのことを
「ドキュメントストリング」という。
「モジュールの冒頭」「クラスの冒頭」「関数の先頭」に、
「ドキュメントストリング」でコメントを記述する。
「ドキュメントストリング」は、「モジュールオブジェクト」「クラスオブジェクト」「関数オブジェクト」の「__doc__」アトリビュートで参照することが可能。
「ドキュメントストリング」は、対話モードの「help()」 でも参照可能。
サンプルコード
Sample.py
"""A Sample module"""
class SampleClass:
"""A Sample class"""
def SampleFunc(self, x, y):
"""A Sample function"""
return x + y
Sample2.py
import Sample
print Sample.__doc__ #=> A Sample module
print Sample.MyClass.__doc__ #=> A Sample class
print Sample.MyClass.myfunc.__doc__ #=> A Sample function
Back