Selection for my Life

いま、僕にできること。

きれいなコードが書きたいな。 ててててん コーディング規約~~

きれいなコードが書きたいな。

きれいなコードってどんなだ?

ソース嫁んで勉強しろっ って言わないで・・・。涙

 

 コーディング規約を勉強することが、きれいなコードへの近道!?

てなわけで、下記、規約を流し読み。

http://pear.php.net/manual/ja/standards.php

 

コメント

インラインのコメントブロック (docblocks) を必ず表記します。 PEAR パッケージに対するコメントブロックの表記方法については、 サンプルファイル およびヘッダコメントブロック のセクションを参照してください。 詳細な情報は、 http://www.phpdoc.org/ にあります。

インラインドキュメント以外のコメントを書くことも推奨します。一般的な目安として、 コードのある部分を見て「言葉だけで説明したくないな」と思うような場合には、 処理内容を忘れてしまう前にコメントを追加する必要があります。

C 言語形式 (/* */) と標準 C++ コメント (//) のどちらも使用可能です。 Perl/shell 形式のコメント (#) は使用するべきではありません。

 

って書いてありますね。へぇへぇ~~。 #って使わないほうが良いのかぁ~。

Perlを使うときは、結構#入れてましたけど・・・。

言語によって、コメントの書き方を変えるの面倒だと思ってしまう・・・。きれいなコードを書かれる人はどんな規約に従って書いているのかなぁ~。

 

やはり、いろんな人のコードを見て参考にするのが良いのだろうねぇ~。