[Python/コメント - バックアップ No.2 を復元して編集]

ページへ戻る

− Links

印刷

Python/コメントの編集

詳細な入力項目を表示

ページタイトル( 空白で自動設定 ):
ページ並び順( 0-9 小数可標準:1 ):
ページ別名(複数は[改行]で区切る):

ページ内容:

*コメント機能とは [#e21819cf]
プログラムでのコメントとは、ソースコードに記述する、実行には関わらない注釈のことです。

Pythonでも他の言語と同様にコメントが使えますが、ちょっと他とは違う部分もあります。

**コメントを使う前に [#a8790186]

Pythonのver2系では、マルチバイト文字がある場合、そのソースコードの文字コードを指定しないとエラーになります。

これはコメントにも適用されるため、ソース内に日本語文字列がある場合、それがたとえコメントであっても最初の方に次のコメントを入れ、UTF8で保存する必要があります。

# -*- coding: utf-8 -*-

これでソースコードの文字コードが認識されます。

*行コメント [#bdd8ecdd]

Pythonでも、他のスクリプト言語などによくあるように「#」を使った行コメントが書けます。

#これはコメント

print u"コメントのテスト"

結果
 コメントのテスト

このように実行結果には影響しません。

また、インデントにも影響しません。

if True:
 #これはコメント
     print u"コメントのテスト" #ここにもコメントが書ける

結果
 コメントのテスト

一行のコメントならなるべくこちらを使うのがおすすめです。

*文字列を使った複数行のコメント [#n4ea209e]

Pythonには文字列がただそれだけソースコードにあったとしても、実際の処理では無視されるという言語仕様があります。

"この文字列は無視される"
 print u"コメントのテスト"

結果
 コメントのテスト

また、複数行にわたる文字列を「"""」や「'''」で囲んで定義できる、いわゆるヒアドキュメントなどと呼ばれる機能があります。

hd = """複数行の文字列が
 書けます。"""

print hd

結果
 複数行の文字列が
 書けます。

これらのことから、ヒアドキュメントを使って複数行のコメントを実現できます。（1行のコメントは「#」を使えば良いので、普通使いません。）

'''
 複数行のコメントとして
 書ける
 '''
 print u"コメントのテスト"

結果
 コメントのテスト

ただし、これは本当のコメントのように構文解析が完全に行われないわけではありません。
そのため、インデントがおかしいとエラーとなります。

if True:
 '''
 こう書くと
 インデントがおかしいのでダメ
 '''
     print u"コメントのテスト"

結果
   File "comment_test.py", line 18
     '''
       ^
 IndentationError: expected an indented block

インデントを整えれば制御構造の中でも複数行のコメントが使えます。
 if True:
     '''
 インデントすれば
 OK
 '''
     print u"コメントのテスト"

結果
 コメントのテスト

このように複数行のコメントは便利ですが、インデントを気にしないといけないことや、普通の処理としてヒアドキュメントを使っていると、そちらと混じるとわかりづらいという欠点もあります。

また、「#」によるコメントは最近の統合環境などでは、たいてい複数行を一括で自動でしてくれる機能もあるので、処理を一時的に消すにはそちらの方が便利なこともあります。

そのせいか、ヒアドキュメントを複数行のコメントとして使うのは、ファイルの先頭や関数、クラスなどの定義のところなど、制御構造と関わりの無い場所で使われることが多いです。
単にもともと複数行のコメントを必要とするのがそういう場所と言うだけかも知れませんが。

編集の要約:

Q & A 認証: ページ更新時は次の質問にお答えください。(プレビュー時は必要ありません)
Q: 「東京」の読みがな？(ひらがなで)
A:

お名前: タイムスタンプを変更しない

テキスト整形のルールを表示する^[1]

添付ファイル^[2]:

Links list

(This host) = https://njf.jp

^{(This host)}/cms/modules/xpwiki/?cmd=edit&help=true&page=Python%2F%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88
^{(This host)}/cms/modules/xpwiki/?plugin=attach&pcmd=list&refer=Python%2F%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88

Python​/コメント - バックアップ No.2 を復元して編集 :: NJF Wiki

Python/コメント の編集

Links list

Python/コメント - バックアップ No.2 を復元して編集 :: NJF Wiki

Python/コメントの編集