プログラミングスタイルの要素

第2版​​の表紙
著者	ブライアン・W・カーニハンとPJ・プラウガー
公開済み	マグロウヒル
発行日	1978
ページ	168ページ
番号	978-0070342071

Brian W. KernighanとPJ Plaugerによる『 The Elements of Programming Style 』はプログラミング スタイルに関する研究書で、コンピュータ プログラムはコンパイラや個人のプログラミング「スタイル」を満たすだけでなく、人間、特にソフトウェア保守エンジニア、プログラマ、テクニカル ライターにとって「読みやすい」ように記述する必要があるという考え方を提唱しています。1974 年に初版が出版されました。

この本は、タイトルと語調において、 Strunk & WhiteのThe Elements of Styleに明確に敬意を表しており、 Edsger Dijkstra の構造化プログラミングの議論を促進する実用的なテンプレートであると考えられています。この本は大きな影響力を持ち、 The Elements of C Programming Style、The Elements of C# Style、The Elements of Java(TM) Style、The Elements of MATLAB Styleなど、 個々の言語に合わせた一連の同様のテキストを生み出しました。

この本は、プログラミングの教科書に掲載されている実際のプログラムの短い例を基に作成されています。そのため、抽象的または学術的な議論ではなく、実践的な扱いになっています。スタイルは外交的で、批評は概して同情的であり、また恥ずかしげもなく正直です。欠点が指摘されている例のいくつかは、著者自身の作品から取られています (第 2 版の 1 つの例は、第 1 版から取られています)。

その教訓は、各セクションの最後に「汚れ仕事は機械にやらせよう」などの 簡潔な格言でまとめられています。

1. 明確に書きましょう。あまり巧妙に書きすぎないでください。
2. 自分の言いたいことをシンプルかつ直接的に伝えましょう。
3. 可能な場合は常にライブラリ関数を使用してください。
4. 一時変数を多用しすぎないようにしてください。
5. 明確に書きましょう。効率性のために明瞭さを犠牲にしないでください。
6. 汚れ仕事は機械にやらせましょう。
7. 繰り返し表現を共通関数の呼び出しに置き換えます。
8. 曖昧さを避けるために括弧で囲みます。
9. 混乱しない変数名を選択してください。
10. 不必要な分岐は避けてください。
11. 論理式が理解しにくい場合は、変換してみてください。
12. プログラムをシンプルにするデータ表現を選択します。
13. まず、わかりやすい疑似言語で書いて、それから使用する言語に翻訳します。
14. モジュール化します。手順と関数を使用します。
15. プログラムを読みやすく保てるのであれば、goto を完全に避けてください。
16. 悪いコードを修正するのではなく、書き直してください。
17. 大きなプログラムを小さな部分に分けて記述し、テストします。
18. 再帰的に定義されたデータ構造には再帰プロシージャを使用します。
19. 入力の妥当性と妥当性をテストします。
20. 入力がプログラムの制限に違反していないことを確認してください。
21. カウントではなく、ファイル終了マーカーで入力を終了します。
22. 不正な入力を識別し、可能な場合は回復します。
23. 入力を簡単に準備し、出力をわかりやすくします。
24. 統一された入力形式を使用します。
25. 入力内容を簡単に校正できるようにします。
26. 自己識別入力を使用します。デフォルトを許可します。出力で両方をエコーし​​ます。
27. 使用する前にすべての変数が初期化されていることを確認してください。
28. 1 つのバグで止まらないでください。
29. デバッグコンパイラを使用します。
30. オフバイワンエラーに注意してください。
31. 平等に正しい方向に分岐するように注意してください。
32. ループが中央と下部から同じ場所へ出る場合は注意してください。
33. コードが「何もしない」ことを適切に実行していることを確認してください。
34. プログラムを境界値でテストします。
35. いくつかの回答を手動で確認してください。
36. 10.0 × 0.1 が 1.0 になることはほとんどありません。
37. 7/8 はゼロですが、7.0/8.0 はゼロではありません。
38. 浮動小数点数を単純に等しいかどうかだけを基準に比較しないでください。
39. 早くする前に正しくしてください。
40. 高速化する前にフェイルセーフを実現しましょう。
41. 早くする前に明確にしてください。
42. わずかな効率向上のために明瞭性を犠牲にしないでください。
43. 簡単な最適化はコンパイラに任せましょう。
44. 無理にコードを再利用するのではなく、再編成してください。
45. 特別なケースが本当に特別なものであることを確認してください。
46. シンプルにして、スピードを上げましょう。
47. コードをいじって速度を上げるのではなく、より優れたアルゴリズムを見つけてください。
48. プログラムを計測します。効率性を変更する前に測定します。
49. コメントとコードが一致していることを確認します。
50. コードをコメントでそのまま繰り返すのではなく、すべてのコメントを有効に活用してください。
51. 悪いコードにはコメントを付けず、書き直してください。
52. 意味のある変数名を使用してください。
53. 意味のあるステートメント ラベルを使用します。
54. 読者が理解しやすいようにプログラムをフォーマットします。
55. データレイアウトを文書化します。
56. 過剰なコメントはしないでください。

現代の読者は、本書の例で、現在普及している言語とはまったく異なる古い手続き型プログラミング言語( FortranおよびPL/I ) が使用されていることを欠点に感じるかもしれません。本書が執筆された当時、現在普及している言語のほとんどは発明されていませんでした。しかし、本書で取り上げられている文体や構造に関する問題の多くは、特定の言語の詳細を超越しています。

Kilobaud Microcomputingは「他の人が使用するプログラムを書くつもりなら、この本を読むべきです。プロのプログラマーになりたいなら、この本は必読です」と述べています。 ^[1]

• BW カーニハンと PJ プラウガー、『プログラミングスタイルの要素』、McGraw-Hill、ニューヨーク、1974 年。ISBN 0-07-034199-0 
• BW Kernighan および PJ Plauger、『プログラミング スタイルの要素』第 2 版、 McGraw Hill、ニューヨーク、1978 年。ISBN 0-07-034207-5 

• J. Plauger の「プログラミングスタイルの要素」からの引用
• プログラミング スタイルの要素 – 2009 年ブライアン カーニハンのプリンストンでの講演 ( YouTube)