Python 模擬試験

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

コメントの言語と文

PEP 8 が推奨する、コメントの書き方として、最も適切なものを1つ選べ。

  1. A

    完全な文で書き、読む人に通じる言語で書く(国際的に公開するコードなら英語)。

  2. B

    コメントは、単語の羅列にして、できるだけ短くする。

  3. C

    コードと矛盾していても、コメントは更新しなくてよい。

  4. D

    コメントでコードを説明しきれるので、コードの名前は適当でよい。

正解と解説を見る

正解:A

コメントは、読む人に通じる完全な文で、コードと矛盾しないように保つ。英語でない場合も、読み手に合わせた言語で書く。

PEP 8 のコメントの規則。
種類規則
ブロックコメント直後のコードと同じ深さで、行頭は「# 」(シャープと空白)
インラインコメントコードの後ろに空白2つ以上を空けて「# 」。控えめに使う
内容コードを言い換えるだけのコメントは書かない。理由や意図を書く。コードと食い違ったら更新する
言語・文読み手が通じる言語で、完全な文で書く
コメントアウトされたコード残さない(バージョン管理を使う)

学習のポイント:「何をしているか」より「なぜそうしているか」を書く。

この問題を演習で解く →

問題一覧へ

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