プログラミングスタイル

一般的なプログラミング言語には、プログラムを書くときの書式上のルールが厳格に定められているものが多く存在する。たとえば機械語1対1に対応したアセンブリ言語 では、プログラムでは 1行に1文しか書いてはいけないことになっている。

  1:	;;	Sample Assembly Code
  2:	mov	ax, bx
  3:	mul	ax, cx

また、Fortranでは、プログラムを書くことができる桁位置まで決められている。

1行は80文字だが、73文字目以降はコメントとして無視される
1～5桁目には文番号を書く
1桁目に C と書くとその行全体がコメントとして扱われる
6桁目に空白か0以外の文字があると直前の行からの継続行とみなされる
通常のプログラム行は7桁目から72桁目までの66桁内で記述する

(↑これらは覚えなくて良い)


         10        20        30        40        50        60        70
1-----7---+---------+---------+---------+---------+---------+---------+-----

CCCCCC この行は全部コメント CCCCCC
      PROGRAM MAIN
      WRITE(*,10) 'Hello, world'
 10   FORMAT(A)
      STOP
      END

C言語は、1行にどれだけ書いても構わない フリーフォーマット の文法となっている。したがって、このようなへんてこりんな書き方も許される。

#include <stdio.h>
int main/*やー*/(){puts
(/*うっそーん*/"Hello, world"
)
        ;
                               }

しかしこれでは読みづらい。フォーマットが自由であればこそ、読みやすいスタイルで書くことが求められる。

読みやすいスタイル

スペースの空け方、括弧の置き方など、色々な流儀があるが、統一の取れたスタイルは読みやすい。以下のルールは、その数ある流儀の中の一例である。

【インデント(字下げ位置)を揃える】
Emacsであれば全ての行で [Tab] キーを押すことで自動的に揃えられる。
```
if (x > 4) {
  x = 0;
  printf("foo\n");
}
```
揃えることで if, while, for などの制御構文がどこから始まりどこで終わっているかが視覚的に理解できる。
【制御構文の後にはスペースを1つ】
if, while, for, do の直後の条件式の前にはスペースを1ついれる。
```
while (x > 0) {
  printf("あと%d秒\n", x);
  x--;
}
```
【関数の後はスペースを空けずに()を書く】
一般関数の後の引数リストの開き括弧はスペースを空けない。
```
printf("Hello!");
```
【カンマの後はスペースをあけ、前にはあけない】
引数くぎりなどのカンマの後には1つスペースを入れる。上の行とインデントを合わせる場合などは二つ以上入れるのも良い。
```
double foo;
float  x;
sscanf(buffer, sizeof buffer, stdin);
```
括弧、大括弧の内側には空白を入れない
一般的に空白を多めにするとスッキリして見やすくなるが、入れすぎるとどこが大事なのかがつかみにくくなる。とくに括弧の内側は中に数式を入れることが多いので、数式を分かりやすくするためには括弧の内側には空白を入れない方が良い。
```
× …… if ( x < 5 ) {
        }
○ …… if (x < 5) {
        }
○ …… if (x<5) {
        }

× …… x[ MAX_NINZ ]
○ …… x[MAX_NINZ]
```

上記のルールはどれも絶対守らないといけないという性質のものではないが、良いプログラムを作れる人は、自然と上記のような綺麗な書き方になっているものである。