プログラマを悩ませること Top 10 | POSTD
10. 「何か」は分かるが「なぜ」が分からないコメント プログラミング入門コースでは、早い段階かつ頻繁にコメントを記述することを生徒に教えます。プログラムを書き始めた初期段階（ごく単純なコードであっても、時に理解し難いことがあります）では、これは実際に役立つことなのですが、習慣にとらわれてしまうプログラマが多くいます。 上記のコードが何をするのか分かりますか？ 私は分かりません。 問題は、多くのコメントがそのコードが 何をする のかを説明していますが、 なぜ そのコードが書かれているかが説明されていません。では、異なるコメントが書かれた同じコードを見てみましょう。 こちらの方が分かりやすいですね。何が起きているのかを完全に理解できるとは言えませんが、最低でもなぜこのコードが必要なのかが文脈から判断することができます。 コメントは、構文を理解してもらうためにではなく、読み手がコードを理解しや
『リーダブルコード』を他書と読み比べる（その1） - 杉風呂2.0 - A Lifelog -
よい本なので、他書と比較しながら再読していきます。短期集中連載のつもり。 1章 理解しやすいコード ここでは本書の根底となる「すべての原則が生じるテーマ」と「読みやすさの基本定理」について説明がされています。 コードは理解しやすくなければいけない。 コードは他の人が最短時間で理解できるように書かなければいけない。 『C++ スタイルブック (IT Architects’ Archive―CLASSIC MODERN COMPUTING)』の「はじめに」には次のように書かれています。 チームが成果を上げるには、誰もが、他の人の書いたコードを読んで理解できなければならない。 『Code Craft ~エクセレントなコードを書くための実践的技法~』1章「防御的プログラミングの技法」には次のように書かれています。 簡潔性よりも明瞭性を重視してコードを書く 簡潔ではあるのものの混乱を招くおそれのある
クリアなコードの作り方 - How to make clear code - Kouhei Sutou - Rabbit Slide Show
Description 私はコードを書くことが好きです。もっと言うとクリアなコードを書くことが 好きです。クリアなコードを書くことはとても楽しいので、みんながクリアな コードを書けるようになればいいなぁと思っています。そこで、私がどうやっ てクリアなコードを書いているかを紹介します。 I like coding. I say more. I like coding clear code. I hope that we can code clear code because coding clear code is very fun. I'll talk about how I code clear code.
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
