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

短いコードを書く

私が普段コードを書くときに考えていることは常にいかに短くかけるか、ということといかにバグを生み出さないかということです。 基本的にはできるだけ、短くシンプルに書くようにしています。 そうすることであと …

no image

オブジェクト指向 ドメインモデル

本日も引き続き「現場で役立つシステム設計の原則」を読み進めてます。 本日は主にドメインモデルの考え方について。 Contents1 ドメインモデルの考え方1.1 要点1.2 感想 ドメインモデルの考え …

no image

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

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

no image

シェル基礎2

シェルコマンド使い始めて数年たちますが、いまだに知らないことはおおいですし、早く知っとけばよかった的なこともたくさんあります。 そんな小ネタ集を alias よく使うコマンドを別名で登録することができ …

no image

オブジェクト指向 アプリケーション間連携(主にWebAPI)

本日も引き続き「現場で役立つシステム設計の原則」を読み進めてます。 本日はプレゼンテーション層、いわゆるMVCのViewにあたる部分。 Contents1 アプリケーション間連携(主にWEBAPIに関 …