Next: , Previous: Syntactic Conventions, Up: Writing C


5.4 変数と関数の名前付け

プログラムの大域的な変数や関数の名前はコメントのように働く。だから、簡潔 な名前を選ばないように。—代わりに、その変数や関数の意味について役に立 つ情報を与える名前を探しなさい。GNUプログラムでは、名前は他のコメント と同様英語であるべきである。

局所変数の名前はもっと短くていい。なぜなら、それらは一つの文脈の中でだけ 使われ、そこでは(たぶん)コメントがそれらの目的を説明している。

ある名前の単語を分けるのに、Emacsの単語コマンドがその中で使えるように、 アンダースコアを使ってください。小文字にしておきなさい。大文字をマクロや enum定数や一定の取り決めに従う接頭辞のために取っておきなさい。

例えば、ignore_space_change_flagのような名前を使うべきだ。 iCantReadThisのような名前を使ってはいけない。

コマンドラインのオプションが指定されたかどうかを示す変数は、オプションの 文字ではなく、オプションの意味にちなんだ名前を付けるべきだ。コメントがオ プションの正確な意味とその文字の両方を記述すべきだ。例えば、

     /* Ignore changes in horizontal whitespace (-b).  */
     int ignore_space_change_flag;

一定の整数値に名前を定義したいとき、‘#define’よりもenumを使 いなさい。GDBは列挙定数について知っている。

古いSystem Vシステムで不必要な問題を引き起こさないよう、14文字以下のファ イル名を使いなさい。これを試験するのにdoschkというプログラムを使 うことができる。doschkはまた、MS-DOSファイルシステムにファイルが 置かれたとしたら、名前が衝突する可能性を試験する。—注意してもしなくて も構わないものだ。