変数名や関数名を英文に近い表現にして可読性を上げる



変数名やプロパティ名はどのような名前がいいのか色々調べたら、
英文を意識してコードを書くと可読性向上につながるという内容を発見して、そういう命名もありかと思いました。

たとえば、boolean型の変数名またメソッド名は、YesかNoで答えられるような三人称単数現在形の動詞にします。
そうすると、if文と組み合わせたときに読んですぐに意味が分かりやすいです。

class Driver{

 public bool $hasEntered; //配送先エリアに入ったかどうか

 public function sendNotificationWhenHavingEntered(){

  if($this->hasEntered == true){
   sendNotification();
  }

 }

...

関数の引数についても、以下のように英文を意識することができるようです。

name($user, '山田太郎');

name A B.(AにBと名付ける)ですね。
ちょっとこの例は単純ですが、こういったように引数の順番など少しずつ考慮することで可読性も少しずつ上がっていくような気がしました。

コメントを残す

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