内容へ移動
ゆーものメモ帳
ユーザ用ツール
管理
ログイン
サイト用ツール
検索
ツール
文書の表示
以前のリビジョン
バックリンク
最近の変更
メディアマネージャー
サイトマップ
ログイン
>
最近の変更
メディアマネージャー
サイトマップ
トレース:
書籍:リーダブルコード
この文書は読取専用です。文書のソースを閲覧することは可能ですが、変更はできません。もし変更したい場合は管理者に連絡してください。
====== リーダブルコード ====== プログラマーの必読書とも言われる書籍。特に気になった部分を備忘録として掲載。 ===== 5章 ===== ==== 5.2 自分の考えを記録する ==== === コードの欠陥にコメントをつける === <code> // TODO: もっと高速なアルゴリズムを使う // TODO: JPEG以外のフォーマットに対応する </code> よく使われる記法 <code> TODO: あとで手を付ける FIXME: 既知の不具合があるコード HACK: あまりキレイじゃない解決策 XXX: 危険!大きな問題がある </code> 大切なのは、これからこのコードをどうしたいのかをコメントに書くこと。 それにより、コードの品質や状態を知らせたり、改善の方向を示したりできる。 === 定数にコメントをつける === 定数を定義するときには「背景」が存在する場合が多い。 なかには名前が明確なのでコメントが必要ない定数もあるが、コメントをつけることで明確になる定数は多い。 定数の値を決めたときに頭の中で考えていたことを記録することが大切。 (あとからこのコードを触る人の、定数の意味を調査・推測する時間を節約できる) <code> // 合理的な限界値。人間はこんなに読めない。 const MAX_RSS_SUBSCRIPTIONS = 1000; // 0.72ならユーザはファイルサイズと品質の面で妥協できる。 const IMAGE_QUALITY = 0.72; </code>
書籍/リーダブルコード.txt
· 最終更新: 2020/06/03 10:25 by
humolife
ページ用ツール
文書の表示
以前のリビジョン
バックリンク
文書の先頭へ