個人C++コメント仕様
一、文章の由来
久しぶりにブログを书いて、最近プロジェクトをして、プロジェクトをする过程の中で多种の注釈の问题に出会って、今1つの注釈の规范を整理して、后で私はこの规范に従って注釈します~~良い注釈の习惯を身につけてコードの可読性を高めることに役立ちます(注:すべての人の习惯は异なって、自分の好きな注釈の风格を探し当てることができます)
二、具体的な規範
合計行数の50%を占めるコメントを要求する項目もあります.
2.1ソースファイルヘッダコメント
Øリスト:作成者、作成日、説明.Ø例:
行ごとに80文字の幅を超えないでください.
2.2関数ヘッダコメント
Ø:機能、入力パラメータ、出力パラメータ、戻り値、呼び出し関係(関数、テーブル)などを一覧表示します.Ø例:以下の関数の注釈比較基準は、もちろん、この形式に限定されませんが、上記の情報は含めることをお勧めします.
3.3データ構造宣言の注釈(配列、構造、クラス、列挙などを含む)
これが最も一般的な注釈で、複数のスラッシュで注意を引くことができます.
名前が十分に自己注釈されていない場合は、注釈を付ける必要があります.データ構造に対する注釈はその上の隣接位置に置くべきで、下に置くことはできない.構造内の各ドメインに対するコメントは、このドメインの右側に配置されます.
Ø例:列挙/データ/連合構造は以下の形式で説明できます.
3.4グローバル変数のコメント
Øには、その機能、値範囲、どのような関数またはプロシージャがアクセスするか、アクセス時の注意事項などの説明が含まれています.Ø例:
—END—
参考文献
[1] http://blog.csdn.net/lincyang/article/details/6020785
久しぶりにブログを书いて、最近プロジェクトをして、プロジェクトをする过程の中で多种の注釈の问题に出会って、今1つの注釈の规范を整理して、后で私はこの规范に従って注釈します~~良い注釈の习惯を身につけてコードの可読性を高めることに役立ちます(注:すべての人の习惯は异なって、自分の好きな注釈の风格を探し当てることができます)
二、具体的な規範
合計行数の50%を占めるコメントを要求する項目もあります.
2.1ソースファイルヘッダコメント
Øリスト:作成者、作成日、説明.Ø例:
/*
* Copyright:bupt
* funtion:
* Date:2015-09-01
* Author: Bill Wang
*/
行ごとに80文字の幅を超えないでください.
2.2関数ヘッダコメント
Ø:機能、入力パラメータ、出力パラメータ、戻り値、呼び出し関係(関数、テーブル)などを一覧表示します.Ø例:以下の関数の注釈比較基準は、もちろん、この形式に限定されませんが、上記の情報は含めることをお勧めします.
/*************************************************
Function: //
Description: // 、
Calls: //
Table Accessed: // ( )
Table Updated: // ( )
Input: // ,
// 、 。
Output: // 。
Return: //
Others: //
*************************************************/
3.3データ構造宣言の注釈(配列、構造、クラス、列挙などを含む)
これが最も一般的な注釈で、複数のスラッシュで注意を引くことができます.
名前が十分に自己注釈されていない場合は、注釈を付ける必要があります.データ構造に対する注釈はその上の隣接位置に置くべきで、下に置くことはできない.構造内の各ドメインに対するコメントは、このドメインの右側に配置されます.
Ø例:列挙/データ/連合構造は以下の形式で説明できます.
/////!!!
enum WinSwitcherType{
WS_NONE = 0, //
WS_NAME, //
WS_PORT_SINGLE,//
WS_PORT_DOUBLE,//
WS_VALUE_TEXT,//
WS_VALUE_INT,//
WS_VALUE_DOUBLE,//
WS_VALUE_BOOL,//
WS_FILW_PATH, //
WS_INPORT //
};
3.4グローバル変数のコメント
Øには、その機能、値範囲、どのような関数またはプロシージャがアクセスするか、アクセス時の注意事項などの説明が含まれています.Ø例:
/* The ErrorCode when SCCP translate */
/* Global Title failure, as follows */ // 、
—END—
参考文献
[1] http://blog.csdn.net/lincyang/article/details/6020785