skillup

技術ブログ

プログラミング全般

命名規則について その2

投稿日:

リーダブルコードネタ第3段。

前回のエントリーに引き続き、名称の大切さについて

あいまいな名前はNG!

これは実務でもしょっちゅう悩まされてます・・・

リーダブルコードの例としてはfilter~とかだと何をフィルタリングするかわからないから・・というように書かれてました。ここでも具体的な名称の大切さが問われます。

いかにリーダブルコードがすすめる一般的なルールなぞを。

限界値はmaxかminを使う

範囲を指定するときはfirstとlast

a=fisrt , b= lastだったとすると取りうるxの範囲は a<= x <= b

排他的な範囲はbegin,end

a=begin,b=endだとすると取りうるxの範囲はa<=x < b。日時などでよく使われる

bool型では変数名にis,has,shoud,canを付けるとわかりやすい

一般的には否定より肯定のほうが意味がとりやすい

if文でもtrueのほうがfalseよりもわかりやすいですね。否定の否定みたいな書き方だと一瞬どっちだ?となりますので、頭を無駄に使うようなメソッドはやめておいたほうがいいでしょう。

一般的な命名ルールを逸脱するような名称は使わない

getはただのアクセサなのでこれで値を計算したりすることはしないほうがいいでしょう。

-プログラミング全般
-

執筆者:


comment

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

関連記事

no image

コメントについて

リーダブルコード 第5・6章はコメントについて。 今回はコメントです。ここは結構賛否両論になるところではないかと思います。 ざっくり分けると「できるだけコメントは詳しく書くこと」という意見と「コメント …

no image

オブジェクト指向 クラスの設計と業務ロジックの整理

本日も引き続き「現場で役立つシステム設計の原則」を読み進めてます。 本日は主にクラスの作り方について。 Contents1 クラス設計と業務ロジック1.1 要点1.2 感想 クラス設計と業務ロジック …

no image

フォームの処理について

本日はフォームの処理に関して。主に一覧検索画面のフォームについてです。 フレームワークでフォームの処理をする場合、変数の初期値やバリデーションなどをあらかじめ読み込むオブジェクトを設定しておき、変数が …

no image

シェルスクリプト ファイル読み込み・switchなど

以前のエントリーに引き続き、シェルスクリプトでログを解析する処理があってそこで覚えたことなどをまとめておきます。 Contents1 ファイル読み込み2 switch文2.1 基本パターン2.2 条件 …

no image

emptyの扱いに関して

PHPで空白や存在確認として便利なemptyですが、乱用すると意図しない動きをすることがあるケースが多々あります。 Contents1 emptyの挙動に関して2 数値の03 検索などの全判定と値のな …