モジュールの docstring
モジュール全体の説明を書く docstring の位置として、PEP 8 が示すものを1つ選べ。
- A
ファイルの末尾
- B
最初の関数の後ろ
- C
import の後ろで、最初のクラスの前
- D
ファイルの先頭(import より前)
正解と解説を見る
正解:D
モジュールの docstring は、ファイルの先頭(from __future__ 以外の import より前)に書く。__doc__ や help() で参照される。
| 項目 | 規則 |
|---|---|
| 書く対象 | 公開するモジュール・関数・クラス・メソッド |
| 書き方 | 三重の二重引用符(""")。1行目に要約を書く |
| 複数行 | 要約の後に空行を入れ、閉じの """ は単独の行に置く |
| モジュールのdocstring | ファイルの先頭に置く(importより前) |
| 文体 | 1行目は命令形で、ピリオドで終える(「〜を返す」など) |
| バックスラッシュを含む場合 | raw文字列(r""")にする |
- A
誤り。先頭に書く。
- B
誤り。ファイルの最初の文。
- C
誤り。import より前。
- D
正しい。モジュールの docstring は、ファイルの最初の文として書く。
このサイトの問題は、各試験の公式に示された出題範囲に沿って作ったオリジナルの模擬問題です。本試験の問題ではありません。一般社団法人Pythonエンジニア育成推進協会の公式サービスではありません。