icon
icon

Pythonのダブルクォーテーション3つで囲まれたコメントについて現役エンジニアが解説【初心者向け】

初心者向けにPythonのダブルクォーテーション3つで囲まれたコメントについて現役エンジニアが解説しています。コメントはプログラムの処理がスキップ(無視)される個所になります。メモやデバッグに使いますが、複数行のコメントにはダブルクォーテーションを3つ書きます。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

Pythonのダブルクォーテーション3つで囲まれたコメントについて、TechAcademyのメンター(現役エンジニア)が実際のコードを使用して、初心者向けに解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

 

なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

Pythonのダブルクォーテーション3つで囲まれたコメントについて詳しく説明していくね!

大石ゆかり

お願いします!

Pythonだけに限りませんが、プログラミングにおいてコメントは重要な役割を果たします。

他人や自分のためのメモとして使うのはもちろんのこと、コメントアウトしてデバッグする際にも役立ちます。また、フォルダのdeleteなどの一度行うと取り返しがつかないようなコードをコメントアウトし、deleteされるフォルダを確認してからコメントを外すといった使い方もあります。

ただ、多くの記事や参考書ではコメントについてあまり詳しく書かれていないのが現状です。そこでこの記事では、Pythonにおけるコメントについての仕方について徹底的に解説します。

ダブルクォーテーション3つで囲まれたコメントについて

普通のコメントを#で行うのは多くの方がご存知かと思いますので、複数業のコメントのやり方から解説していきます。複数行のコメントを書こうと思った際に以下のように書くのは面倒ですよね。

#コメント1行目
#コメント2行目
#コメント3行目

そのため、複数行コメントは以下のようにダブルクォーテーションで囲んであげるのが普通です。

"""
コメント1行目
コメント2行目
コメント3行目
"""

こうすることで、例え膨大な行のコメントを書かなければならなくなったとしても、瞬時にコメントを作成できます。また、複数行コメントはダブルクォーテーションでなくシングルクォーテーションを用いて以下のように書くこともできます。

'''
コメント1行目
コメント2行目
コメント3行目
'''

 

シングルクォートとダブルクォートの違い

ではシングルクォートとダブルクォートのどちらを使えばいいのでしょうか?結論から言うと、どちらでも大丈夫です。完全に好みの問題です。

ただし、以下のようにコメント文自体にクォーテーションを使いたいときには、以下のようにシングルクォートとダブルクォートを分けた方が見やすいでしょう。

'''
一番上を"header"という。
真ん中を"body"という。
一番下を"footer"という。
'''

 

[PR] Pythonで挫折しない学習方法を動画で公開中

その他のコメントの書き方との比較

その他のコメントの書き方として、関数アノテーションというものがあります。

これはPython3系から追加された機能です。このようにして関数に関する説明をする方法もあります。アノテーションの箇所には変数のデータ型を書くことが多いです。ただし、初心者の方は知らなくても大丈夫かと

def function_2st(s: "sのアノテーション", t: "tのアノテーション") -> '戻り値のアノテーション':
return 2 * s * t

 

まとめ

この記事ではPythonのコメントの書き方について徹底的に解説しました。これで今後コメントについて悩むことはなくなるでしょう。

コラム

コスパとタイパ、両方結果的に良くなる良くなる学び方とは?

「スクールは高いし時間も縛られて効率が悪い」と考える方は多いと思います。
もちろん、時間も費用もかかることは間違いありません。
ただ 結果的に無駄な学びにお金も時間もかける方がリスクが高いという考えもあります。

コスパ・タイパ最適化の参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

  • ・困ったときに、質問や相談できる相手がいるため挫折しなかった
  • ・プロとして必要なスキルのみを深く学べたので無駄がなかった
  • ・副業案件の提供と納品までのサポートがあったので目的を達成できた

安価・短期間で広く浅く学んでも意味がありません。 本当に自分の目的が達成できるか、それが重要です。
自分にどのスキルや学び方が合っているか、どんな学習方法かなど、お気軽に 無料相談 に参加してみませんか?

カウンセラー・現役のプロへ、何でも気軽に無料相談可能。 30分か60分お好きな時間が選べて、かつ3回まで すべて無料で ご利用できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら相談した方限定の割引・参加特典付き! 無料相談はこちら

監修してくれたメンター

柴山真沙希(しばやままさき)

大手IT企業などでエンジニアとして2年ほど勤務した後、個人事業主としてプログラミングスクール「エンペサール」を経営。子供から大人まで幅広い層を対象にプログラミングを教えている。

得意言語はPython, HTML, CSSで、機械学習やデータ分析、スクレイピングなどが得意。サッカー観戦や読書が趣味である。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

TechAcademyでは、初心者でも、Pythonを使った人工知能(AI)や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。

また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。

初心者・未経験でもできる。まずはテックアカデミーに相談しよう

プログラミングを独学で学習していて、このように感じた経験はないでしょうか?

  • ・調べてもほしい情報が見つからない
  • ・独学のスキルが実際の業務で通用するのか不安
  • ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 学習に不安を抱えている方へ、マンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう カウンセラーやエンジニア・デザイナー があなたの相談に真摯に向き合います。

「自分に合っているか診断してほしい」
「漠然としているが話を聞いてみたい」

こんなささいな悩みでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。(1週間限定)

今なら参加者限定の割引特典付き! 無料相談を予約する