Date: Sun, 27 Jun 99 19:15:59  JST
From: SHUDO Kazuyuki <shudoh at muraoka.info.waseda.ac.jp>
Subject: [JavaHouse-Brewers:26301] coding style (Re: =?ISO-2022-JP?B?GyRCSjg7ek5zMHo/dCROOzI+SEVPJDchSk0+Q0whSxsoQg==?=)
To: java-house-brewers at java-house.etl.go.jp (JavaHouse Brewers ML)
Message-Id: <199906271013.TAA14974@cafe.muraoka.info.waseda.ac.jp>

首藤です。

矢田さん wrote:

> > void test(char *str){ /* Javaをしらなかったときは、
> >                      こんなところに { はもってこなかったんだかなぁ */

> 私が初めてC言語を習ったとき、当時C言語歴10年くらいの先輩には、
> このような書き方をするようにきつく指導されてました。

>   function ( )
>   {
> と書くと、 ”{”だけの余分な行が増えてしまい、

このような、コード記述の様式
  `{' をどこに書くか
  コメントをどこに書くか
  字下げ幅
  変数名の付け方の規則
  空白の入れ方
などなどのことを、コーディングスタイルと言います。
この ML でも、過去に話題になったことがあります。
  - [JavaHouse-Brewers:9135]  conding convention for {}
  - [JavaHouse-Brewers:12713] CODING STYLE
  - [JavaHouse-Brewers:5674]  Source Style of Java

例えば C 言語であれば、K&R, GNU 他、知られたスタイルがいくつかあります。

ちょっと web 上を漁ったところ、以下のページが目に止まりました。
  - Indian Hill Style Manual の和訳
    http://dennou-k.gaia.h.kyoto-u.ac.jp/arch/comptech/cstyle/index.htm
  - Linux kernel coding style
    <Linux のソース>/Documentation/CodingStyle
  - Linux kernel coding style の和訳
    http://www.keisana.ike.tottori-u.ac.jp/~kawamura/linux/translations/coding-style.html
  - Ruby のコーディングスタイルに関する一考察
    http://www1.u-netsurf.ne.jp/~brew/mine/ruby/style.html

また、comp.lang.c の FAQ リスト (web 上に和訳もあります) にも、
コーディングスタイルに関するセクションがあります。

他に何か面白い参考文献をご存知の方、教えて下さい。


> と書くと、 ”{”だけの余分な行が増えてしまい、
> 行数が増えるからソースが見にくくなるって言うのが
> 当時聞いた理由でした。

「`{' だけで一行にしろ。行数が増えるから。」とか言われなくてよかったですね。
＃ソフトウェアメトリクスの話題への発展希望。:)

> ＃ DOSなんかで開発してると表示行数が少ないですから。。。
> あと、人間工学（？）的にも、

> ＃ 果たして、どっちがいいんでしょうね？

それぞれの記述法によいところがあり、スタイル A の方が
絶対にどんな局面でも間違いなくよい、と言い切れないことが多いです。
どの記述法を好むか、というのは宗教のようなものでして。

「どのスタイルを選ぶかよりも、ひとつのスタイルを一貫して使うことが大切だ」
という C FAQ の言葉にはうなずかされます。


SHUDO Kazuyuki/首藤一幸   私をたばねないで あらせいとうの花のように
  shudoh at muraoka.info.waseda.ac.jp