フリーランスエンジニア 仕事
2020-06-13

プログラマが絶対守るべきこと（連載第３回目：変数名について）

投稿者: KuRo

変数名を考えるのに時間をかける

/** データベースから name の連絡先を返却 */
public static Address getAddress(String name){
    return addressDb.getAddress(name);
}

public class Address{
    public String name;
    public String tel1;
    public String tel2;
}

public static void main(String[] args){
    Address address = getAddress(args[0]);
    System.out.println(args[0] + “さんの携帯電話番号は” + address.tel1);
    System.out.println(args[0] + “さんの自宅電話番号は” + address.tel2);
}
tel1 が携帯電話であることを、System.out.println の中でのみ説明しています。
100人に聞いて100人が 「tel1 といえば携帯電話だろっ！」ならいいのですが、そうではないと思いますよ。
これは、「斎藤さんの双子」を「双子１、双子２」と呼ぶことと同じです。

こうしてほしい例

/** データベースから name の連絡先を返却 */
public static Address getAddress(String name){
    return addressDb.getAddress(name);
}

public class Address{
    public String name;
    public String telHome;
    public String telMobile;
}

public static void main(String[] args){
    Address address = getAddress(args[0]);
    System.out.println(args[0] + “さんの携帯電話番号は” + address.telMobile);
    System.out.println(args[0] + “さんの自宅電話番号は” + address.telHome);
}
tel が接頭辞になっているのがポイントです。
同じ仲間を意味する言葉をグルーピングするときは、接頭辞でグルーピングできるよういに統一すると、言葉にさらに意味が加わります。
プログラムが大きくなればなるほど、1画面で確認できるのは部分的な切り取りになります。
そこでぱっと見、何を表すものなのかがわかることは、早く少ない文字数でコーディングすることよりも将来性のあるプログラムだと思っています。
変数名はぜひ時間をかけて命名してほしいものです。

投稿者について

元警察官の安全確保支援士資格保有、フリーランスエンジニアです。 WEB系バックエンドを主軸にアプリ開発、インフラ構築なども手掛けています。 いずれはすべてのスキルを底上げしてフルスタックエンジニアと胸を張って言えるようになりたいです。 ■facebook では、警察官時代の先輩、イケメンコメンテーター「佐々木成三」さんとタッグを組んで、テレビやラジオ、イベントなどに参加させていただいている様子などをご紹介しています。 ■毎月1回、調布FMのラジオ番組「Middle Age Cafe」にパーソナリティとして参加しています。アプリで聞いてね。 ■自前のブログ「TechnoKuRoプログ」で、プログラミング技術、サーバ技術や、仮想通貨のマイニングなど、PC関連の話題を取り上げて不定期更新しています。 ■LINEオープンチャット「フリーランスエンジニア」を運営しています。ここでは100名を超えるフリーランスやフリーランスを目指す人たちが、皆さんの質問への解答はもちろん、くだらない雑談まで、ゆる～く会話しています。ぜひ参加してみてくださいね。

コメントを残す

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