プログラマ専用SNS ミクプラ

他の人が読みやすいプログラムを書くのは難しいって聞いたことを思い出して…
********①************
void main(){
	printf("…");
}
********************
と
*********②***********
void main()
{
	printf("…");
}
********************
どっちが見やすく思いますか？

コメントはどの位置に付けますか？
どんな風に付けますか？
などなど、あると思いますが…（これだけしか思い浮かばなかったんだけど(^^;Λ

皆さんはどうでしょうか？
自分なりの規則を持っている方はいますか？

因みに僕は、、、、
①なのですが、①だと見にくいと思うときがあったりして、
最近ごちゃごちゃに使ってしまっているので、他の人はどうなんだろ？
って思いスレ立てしました＾＾

コメントは
**************************
一行の時：
//・・・・・・
printf("・・・・・");

複数行の時：
/*
	・・・・・・
	・・・・・・
	・・・・・・
*/
printf("・・・・・・");

forなどループを使う時：
for ( ; ; ){	//
	printf("・・・");
}
***************************
のような感じでやっています。
ただ、その時々によって変わってる感じがしますが・・・ｗ

ご意見よろしくお願いします！！
＋α：「これは勘弁！」と言うのがあったら教えていただけると、凄い参考になります＾＾

***********以下追加事項（6/16）**************************
自作関数と関数の名前の付け方はどうでしょうか？

僕は、長いのは先頭が大文字の英単語の羅列にしていますが、どうでしょうか？
短いのは小文字の
例：）Sample_game();　　Sanple_game;
      game();           game;

void main(){
	printf("…");
}

void main()
{
	printf("…");
}

#include <stdio.h>

int main(){
	int i,a=0;
	for(i=0; i<10; ++i)    //aの値は??/
	    ++a;
	printf("a=%d",a);
	return 0;
}

int cnt(){
	int i,a;		//iとaを宣言
	a=0;			//aを初期化
	for(i=0; i<10; i++)	//10回ループ
	    ++a;		//aをカウントアップ
	printf("a=%d",a);	//aを表示。
	return a;		//aを返す
}

if (isFoo() && ifBar()) {

if (isFoo() &&
    isBar())
{

if (x == 0) return;

#if 0
...
#endif

>管理人様

>途中に/**/があると、大きな範囲でコメントアウトしたい時に、中に/**/があると、それより大きな範囲から/**/がかけないからです。 
なるほど、確かにそうですね…これから注意してみたく思います。

トライグラフの例ですが、a=10　となり、何も問題が無かったのですが、何が起こるのでしょうか？
トライグラフは、三文字で記号を表すものと解釈しました。

>「友達のプログラムソースをコピーして提出している学生」
友達に教えた人がいた時、そのプログラムが機能することが無いと思いますがどうでしょうか？
友達に教える時にそういうのには注意した方がいいのでしょうか？…注意が出来るかどうかわかりませんが＾＾；

>趣旨から離れてしまいました。すみません。 
趣旨の中から全然離れていません。
むしろ、大歓迎です！


>もしかして、「ポインタの扱い方・・・？」トピで書いた私のサンプルのコメントがみにくかったですか？＾＾； 
違います。
先生が、
void main () 
{
	printf();
}
で書けと言っていたのに何で
void main() {
	printf();
}
で書くの？
って聞かれたからです・・・・・・・・orz
なので、他の人はどうだろう？と思い書いて見ました。

>Justy様
>・　可読性が高い 
とは、どの様なのを指すかが、凄く曖昧な気がするのですが、どうでしょうか？

>・　保守性が高い
申し訳ないのですが、良く分かりません。
説明お願いできませんか？

>細かくルールを持ってますよ（ｗ
>しかも大体１，２年周期でプロジェクトが終わるタイミングで書き方を改善していっています
Σ(゜Д゜
それは、メモ帳などに記載して、やっているのか、記憶を頼りにしているのかどちらなのでしょうか？
参考までにお願いできますか？

>インデントがおかしいソース
には、
void main(){
	printf("・・・・・");	//・・・・・・・・・・。
	printf("…");	//・・・・
}
は入ると思われますか？

>if文の条件がたくさんある時など 
>１行にたくさんの条件文を書き連ねてエディタを横スクロールさせないと見えない、 
>なんてのは論外です。 
なんと、出来る限り横に書いていくものだと思っていました。＾＾；

>組岸紙織様
なるほど、自分なりの関数の名前の付け方を決めておくと言うのも、かなりいいと思います。
ただ、ハンガリアンがあまり良くないそうなので、難しそうですが・・・。

>YuO様
文の長さによって色々と使い分けられているのですね。
凄いです！

>C95
とは、何なのでしょうか？
>基本はプリプロセッサ使って削除ですね。 
>
>#if 0
>...
>#endif
これにはどの様な意味があるのでしょうか？
ググったても、使い方すら理解できませんでした。
[プリプロセッサ　#if 0][プリプロセッサ]で検索をかけました。


質問文に、関数の名前の付け方も編集して追加させていただきます。
色々と参考になります。

[color=#d0d0ff" face="monospace]void sample(void)
{
    int n;
    if(....)
    {
        int n;
        
    }
}[/color]

[color=#d0d0ff" face="monospace]
switch(mode)
{
    case MODE_EXTREAM:      a++;
                            break;
    case MODE_ALT:          a+=2;
                            break;
    case MODE_DOUBLE_TIMES: a*=4;
                            break;
}[/color]

[color=#d0d0ff" face="monospace]switch(mode)
{
    case MODE_EXTREAM:                  a++;
                                        break;
    case MODE_ALT:                      a+=2;
                                        break;
    case MODE_DOUBLE_TIMES:             a*=4;
                                        break;
    case MODE_AAAAAAAAAAAAAAAAAAAAAAA:  a*=8;
                                        break;
}[/color]

＞void main(){
＞	printf("・・・・・");	//・・・・・・・・・・。
＞	printf("…");	//・・・・
＞}
＞は入ると思われますか？

[color=#d0d0ff" face="monospace]    for(i=0; i<max; ++i)
        count++;
        printf("count = %d\n", count);
        if(count == max - 1){
            printf("abcdef\n");
    }[/color]

[color=#d0d0ff" face="monospace]    if(note == 1 || note == 4 || note == 6 || note == 9 || note == 11 || key == 1 || key == 4 || key == 6 || key == 9 || key == 11)[/color]

[color=#d0d0ff" face="monospace]    if(note == 1 || note == 4 || note == 6 || note == 9 || note == 11
    || key  == 1 || key  == 4 || key  == 6 || key  == 9 || key  == 11)[/color]

if(){
    /*色々１*/
  goto label;
 }else{
    /*色々２*/
label:
   /*色々３*/
}

返信遅れてすみません。

> Justy様

>異なるスコープで同じ変数名を宣言してしまうと、書いている人はともかく、 
>読む人は結構混乱します。
　確かに、気おつけなくてはいけないです。
自分でも後で見たら混乱しそうですし…

>保守性…（略）…が高いということは簡単に修正ができることを意味しています。
　関数内でしか使用しないものは、定義する必要は無いと取っても良いのでしょうか？

↓①
int Game(void)
{
	int n;
	…
	return n;
}

↓②
int Game(int a)
{
	int n,i;
	i = GameOut(n,a);
	
	return i;
}

　簡単に書いてますが、これが長く長く続く時、①はしても良く、②はしない方が良い
と解釈しましたがあってますでしょうか？

↓②'
int Game(int RPG)
{
	int name,i;
	i = GameOut(name,RPG);
	
	return i;
}
②→②’としておけばOK？


>他にも意外なケースとして例えば、switch-caseで以下のように書く人がいたとしましょう。
　では、↓の様な形でもいいのですか？

switch(mode)
{
    case MODE_EXTREAM:		a++;
				break;
    case MODE_ALT:		a+=2;
				break;
    case MODE_DOUBLE_TIMES:	a*=4;
				break;
    case MODE_AAAAAAAAAAAAAAAAAAAAAAA:	a*=8;
					break;
}

また、
{
    case MODE_EXTREAM:
    		a++;
		break;
    case MODE_ALT:
    		a+=2;
		break;
    case MODE_DOUBLE_TIMES:
    		a*=4;
		break;
    case MODE_AAAAAAAAAAAAAAAAAAAAAAA:
    		a*=8;
		break;
}
はよくないのでしょうか？

>平日は一日だいたい最低４時間、多いときになると十数時間はプログラムしてるので、 
>細かなルールを意識することなくもう惰性で書いてます。
　えっ！…流石にそれだけやると違うんですね…（汗

>あとは横に長いと印刷したときに見苦しくなるというのもありますね。
　確かにそうだと思います。
印刷はあまりしたことが無かったので、考えていませんでした。
しかし、

>if(note == 1 || note == 4 || note == 6 || note == 9 || note == 11
>|| key  == 1 || key  == 4 || key  == 6 || key  == 9 || key  == 11)

　これは、ifがとても見にくくなっているような気がします。
どうなんでしょうか？多く書くようになると、簡単に判断が出来るようになるのでしょうか？

if(note == 1 || note == 4 || note == 6 || note == 9 || note == 11
    || key  == 1 || key  == 4 || key  == 6 || key  == 9 || key  == 11)
{
	…
}
と、タブを一つ入れたほうが見やすくなると思うのですが、どうでしょうか？

>ただ、Cですと（名前空間などが使えないので）意味を区切るために _ を使うとがあります。 
なるほど、名前空間と言うものがあったんですね。(マテ
思わぬところで良い勉強になります。

>発音が似ているのとか、意味が似ている別の単語とかも同様です。 
　日本人なので…じゃ済まないんですよね…orz
ここで、英語が出てくるとは世の中はどこもかしこも英語が必要だと思い知りました。orz



>組木紙織
これから拡張を考えてるとか？ｗ

[color=#d0d0ff" face="monospace]    if(IsSpecialNoteKey(note, key))
    {
        ....
    }[/color]

#define CODE 1
int printf (const char *, ...);

int main (void)
{
#if CODE == 1
    printf("Hello, World!\n");
#elif CODE == 2
    printf("Hello, C World!\n");
#else
    printf("Hello, Unknown world...\n");
#endif
}

{
    for (int i = 0; i < 10; ++i) { /* 配列をiで列挙していく */ }
    /* ... */
    for (int i = 0; i < 10; ++i) { /* 配列をiで列挙していく */ }
}