Python 模擬試験

PythonZen & PEP 8 模擬試験 第2回 問15・PEP 8 コメントとdocstring(docstring)

複数行 docstring の閉じ

PEP 8(PEP 257)が推奨する、複数行の docstring の書き方として、最も適切なものを1つ選べ。

  1. A

    閉じの三重引用符は、最後の文字と同じ行に必ず置く。

  2. B

    要約は書かず、詳細だけを長く書く。

  3. C

    1 行目に要約を書き、空行のあとに詳細を書く。閉じの三重引用符は、単独の行に置く。

  4. D

    docstring は、関数の外に書く。

正解と解説を見る

正解:C

複数行の docstring は、要約の行 → 空行 → 詳細の順に書き、閉じの """ は単独の行に置く。

PEP 8(と PEP 257)の docstring の規則。
項目規則
書く対象公開するモジュール・関数・クラス・メソッド
書き方三重の二重引用符(""")。1行目に要約を書く
複数行要約の後に空行を入れ、閉じの """ は単独の行に置く
モジュールのdocstringファイルの先頭に置く(importより前)
文体1行目は命令形で、ピリオドで終える(「〜を返す」など)
バックスラッシュを含む場合raw文字列(r""")にする

学習のポイント:1 行の docstring は、閉じの三重引用符を同じ行に置く。

この問題を演習で解く →

問題一覧へ

このサイトの問題は、各試験の公式に示された出題範囲に沿って作ったオリジナルの模擬問題です。本試験の問題ではありません。一般社団法人Pythonエンジニア育成推進協会の公式サービスではありません。