Next: System Portability, Previous: Syntactic Conventions, Up: Writing C
プログラムの大域的な変数や関数の名前はコメントのように働く。だから、簡潔 な名前を選ばないように。—代わりに、その変数や関数の意味について役に立 つ情報を与える名前を探しなさい。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ファイルシステムにファイルが
置かれたとしたら、名前が衝突する可能性を試験する。—注意してもしなくて
も構わないものだ。