http://sysart.co.jp)SYSART-MAGAZINEホームアバウト勉強日記グラフィックデザインWEBデザインWordPressガジェット研究所Pythonをはじめよう。新名所発掘スマホで写真お問い合わせホームアバウト勉強日記グラフィックデザインWEBデザインWordPressガジェット研究所Pythonをはじめよう。#3】読みやすいプログラムを目指そう!(コメント文とスタイルガイド)Pythonをはじめよう。コピー2019.05.08スポンサーリンクSYSARTアプリ開発部のワクワクUMA博士です。GW中は長崎県の雲仙地獄めぐりにいってきました。おみくじを引いたところなんと大吉。「これ天啓では?」と宝くじを買ってみました。こんどこそ億万長者になっていることでしょう!さて前回は簡単なプログラムの作成とPyファイルの作り方を勉強しましたね(前回リンク)。今回は実践編ですが、少し基本的なところで”コメント文”や“読みやすいコードの書き方”やといったプログラムを整理しながら作る方法を勉強したいと思います。ゆうの覚えておくと、後々の学習効率の向上や効率化につながっていくので割と大事ですよ!(と個人的には思ってます)今回の記事で紹介するのは、次の通りです。スポンサーリンク目次コメント文ってなに?(1)試しに書いて実行してみよう!(2)コメント文ってどうゆう書式?(3)どうゆうときに使うの?コードを見やすく書くために(スタイルガイドPEP8)(1)あると便利な共通認識。前回記事で作成したprinttest01.pyを利用してみます。ファイルをコピーしてファイル名を「Study03_test01.py」にしてから編集してみましょう。赤文字部分のようにプログラムコードの中に「#」から始める文字列を追記してみます。#このプログラムはUMA博士を気持ちよーくする言葉をつづります。endを指定しない場合は終端文字は改行となります。endを空白に指定したため次のprint出力は改行されず表示されます。pyファイルを忘れずに保存してから、実行してみましょう。結果は前回の出力結果と変わらないはずです。コメント文とは、インタプリタが無視する、いわゆる“メモ書き”となります。”「#」で始まりその行末までがコメントの範囲になります。(3)どうゆうときに使うの?主に我々プログラムを作る人たちの為の機能です。他の人にプログラムコードを渡すときや、あとから自分がコードを見たときに「ここはこうゆう意味ですよ」と情報を残した方がスムーズに意思伝達できますよね。他にも「ここは後でこうゆう処理をいれたい」「ここはテスト用にいれた処理だから覚えておこう」といった一時的な覚書きでも良く使う用途です。人によりけりなんでしょうけどコメントってついつい書きすぎたりするんですよね。修正なんかで無駄に開発時間を使ってしまう反省するケースがあったりします...コメントをしっかりかくなら、ある程度開発してから整理して書くのがおススメかなと。※また本記事とはあまり関係ないですが、とても気になる記事をご紹介。変更履歴なんかを頻繁にコメントとして残すのはレガシープログラマみたいです。昔先輩方に教わったようなことも時代の変化ととともに変わっていくんですね。時代においていかれないようにせねば。レガシーなプログラマは思うでした。コードを見やすく書くために(スタイルガイドPEP8)(1)あると便利な共通認識。それがスタイルガイド!プログラムを書く上で、人それぞれ書き方があると、他の人が見たとき見にくかったり後から自分で見返したときに“やっぱりこの書き方にする!”と変な戻り作業がでるときがあります。そんな時に共通のルールがあると便利だと思いませんか?Pythonではスタイルガイド「PEP8」というのが用意されています。(2)必ず守らないといけないの?守らなくてもプログラムは動作するので強制ではないです。開発が進むほどに“前書いたときはどう書いてたっけ?”と余計な悩みを生みがちです。先ほどのコメント文一つとっても以下のように「#」の前後に空白を入れるかどうかでも、ずれがでてしまいます。後々みたときこうゆうの気になるんです。コメント”なのであらかじめ“これに従う!”とルールを決めることで、途中で余計な悩みに右往左往しなくて済むという利点があるのです。強制されていないのかというと柔軟性の話なんですね。ルールに従わせる必要がないような場合やできない場合のために許容はされています。ルール準拠は大事だけど柔軟性も許容できる器ももつ。人間的にも結構大事なことですよね。(3)どうゆうルールがあるの?日本語ドキュメントは以下URLを参照です。ドキュメントpep8-ja.readthedocs.ioただ最初からすべてを読み込むのも大変なので、次の章よりルールに準拠しているかチェックしてくれる便利なツールのご紹介と、代表的なガイドルールをご紹介します。次へ12Pythonをはじめよう。コメントをキャンセルメールアドレスが公開されることはありません。コメント名前メールアドレスサイト次回のコメントで使用するためブラウザーに自分の名前、メールアドレス、サイトを保存する。新しい投稿をメールで受け取るホームガジェット研究所Pythonをはじめよう。長崎市中園町にあるお店の紹介記事です。長崎市大橋町にあるお店の紹介記事です。#03:昼食編】カテゴリーPythonをはじめよう。SYSART-MAGAZINE.メニューホームアバウト勉強日記グラフィックデザインWEBデザインWordPressガジェット研究所Pythonをはじめよう。長崎市中園町にあるお店の紹介記事です。長崎市大橋町にあるお店の紹介記事です。#03:昼食編】カテゴリーPythonをはじめよう。アーカイブ2019年5月2019年4月2019年3月2019年2月2019年1月タイトルとURLをコピーしました。