c-lang:コメントボックス
律義な書き方
code:cpp
/*****************************************************/
/* */
/* 1行でコメントが閉じている。安全だが手間がかかる。 */
/* */
/*****************************************************/
少しくだけた書き方
code:cpp
/*****************************************************
* *
* 上の簡略版。すこし書き易くしてある。 *
* *
*****************************************************/
code:cpp
/****************************************************
* *
* 似ているようで、少し違う。 *
* *
****************************************************/
くだけた書き方
code:cpp
/*****************************************************
*
* 後ろの*を揃えるのは、手間がかかるので省略した。
*
*****************************************************/
code:cpp
/*****************************************************
/*
/* こんな書き方もみました。
/*
/*****************************************************/
さらにくだけた書き方
code:cpp
/*****************************************************
これだけで充分なのかもしれない。
*****************************************************/
code:cpp
/*====================================================
パーツを変えて見ました。
====================================================*/
code:cpp
/*----------------------------------------------------
このように、「=」「-」を使う例はよく見ます。
----------------------------------------------------*/
少し凝ったコメントボックス
code:cpp
/*--------------------------------------------------*
| |
| |
| |
*--------------------------------------------------*/
縦棒型のコメント
code:cpp
/*
*
* これは、かなりメジャーな書き方です。
*
*/
そのバリエーション
code:cpp
/*
**
** こんな書き方もよく見ます。
**
*/
別のバリエーション
code:cpp
/*
||
|| Oracleの本に載っていましたが、それ以外では見たことがありません。
||
*/
code:cpp
/**
* javadoc スタイル
*
*/
/*！
Qt スタイル
*/
ひどい例
code:cpp
/*
ありがちな例
ここはコメント
コメントの記号だけだと、わかりにくい。
（特に、一画面に収まらない場合）
*/
/*
ここはコメント
/* ここもコメント */
ここはコメントではない。
*/
/*
ここはコメント
//
ここもコメント
/*
ここもコメント
*/
ここはコメントではない。
*/
/*
ここはコメント
/*
ここもコメント
*/
ここはコメントではない。
*/
/*ここはコメント*//*ここはコメント*/*ここはコメントではない*///*ここはコメント*/
//* ここはコメント*/ C++では、ここもコメント
/****** 1999/07/25
ここで、一言いっておきたい。
こんな風に、コメントを使って、コメントアウトするんじゃない！！
******/
とんでもない例
code:cpp
/*/
なんじゃこりゃー（(C)松田 優作）
/*/
/*/
すげーわかりにくいぞ。
/*/
/*/
ここはコメント
/*/
/*/
/*/ここはコメントではない
/*/