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

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

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

no image

正規表現その2

10/28に書いた正規表現に関しての追記です。 Contents1 覚えておきたいメタ文字2 留意点 覚えておきたいメタ文字 よく出るメタ文字の復習です。 メタ文字 メタ文字の説明 [] いずれかの1 …

no image

オブジェクト指向について その2

前回のエントリーのように、データとロジックを一体で考えるのは、処理状の有効性のみならず、よりユーザー側に近い処理をかくということにもつながります。 日付の問題に関してもintやshortよりはLoca …

no image

プログラミングを習得するときに必要な2つの大事なこと

元々私は塾で仕事をしていましたが、いろいろ紆余曲折ありましていまではWEBエンジニアとして仕事をしております。 エンジニアとしてのキャリアは3年ぐらいなので正直あまりないのですが、開発者と平行してプロ …

no image

コレクションの頻出処理に関して

PHPでコレクションを使っていますが、慣れると本当に便利ですね・・・まあforeachとかでグリグリやってもいいのですが、無駄にコードが長くなります。 自分がコレクションでよく使う再頻出のメソッドなど …