かぞえチャオ！技術情報のページです。

かぞえチャオ！システムデータ
拡張子個別データ←New
自動実行オプション
ラインカウント方法
ステップ比較方法
ここみチャオ！システムデータ
推奨コーディング規約
比較対象決定方法について
プリプロセッサ指定について
ステップ比較の種類について
静的解析連携機能について
集計しチャオ！の使い方
かぞえチャオ！を使うにあたって
かぞえチャオ！CSV出力フォーマット
かぞえチャオ！でコードレビュー
かぞえチャオ！Ver.1.63の新機能

推奨コーディング規約

かぞえチャオ！で、モジュール切り出しを正確に行えるようにするには、以下のルールに基づいてコードおよびコメントを書いてください。

モジュールヘッダ部

int l_dat; // グローバルデータ //------------------------------------------------------------------------ // モジュールタイトル // ----------------------------------------------------------------------- // 入力：なし // 出力：なし // 戻り：0:OK -1:ERROR // --------------------------------------------------------------------- // 機能：モジュールの説明を記述 // //------------------------------------------------------------------------ int func1(void) {

• 関数ヘッダの最初のコメント行の上に、外部変数などの宣言がある場合は、必ず１行以上空けること。
  空けなかった場合は、変数宣言行も関数ヘッダのコメントに含まれてしまいます。
• 関数名と関数ヘッダのコメントの間に、外部変数やstatic変数の宣言を入れないこと。
• 関数ヘッダのコメントの途中に空行を入れないこと。
• 関数名と関数ヘッダのコメントの間は、空行を入れても入れなくても大丈夫です。

---

static変数を宣言した場合 (1)

int l_dat; // グローバルデータ //------------------------------------------------------------------------ // モジュールタイトル // ----------------------------------------------------------------------- // 入力：なし // 出力：なし // 戻り：0:OK -1:ERROR // --------------------------------------------------------------------- // 機能：モジュールの説明を記述 // //------------------------------------------------------------------------ static int s_tmpdt; int func1(void) {

関数ヘッダのコメントを含む切り出しを行った場合、int func1(void) の行から切り出されます。
この関数の関数ヘッダのコメントは、１つ前の関数に含まれてしまいます。
関数ヘッダのコメントを正しく切り出すには、 外部変数やstatic変数の宣言は、ファイルのヘッダ部でまとめて行ってください。

---

static変数を宣言した場合 (2)

int l_dat; // グローバルデータ //------------------------------------------------------------------------ // モジュールタイトル // ----------------------------------------------------------------------- // 入力：なし // 出力：なし // 戻り：0:OK -1:ERROR // --------------------------------------------------------------------- // 機能：モジュールの説明を記述 // //------------------------------------------------------------------------ static int s_tmpdt; // テンポラリデータ int func1(void) {

外部変数やstatic変数の宣言行に、コメントがある状態で
関数ヘッダのコメントを含む切り出しを行った場合は、static int s_tmpdt; の行から切り出されます。
この関数の関数ヘッダのコメントは、１つ前の関数に含まれてしまいます。
関数ヘッダのコメントを正しく切り出すには、 外部変数やstatic変数の宣言は、ファイルのヘッダ部でまとめて行ってください。

また、外部変数やstatic変数の宣言は、関数ヘッダのコメント先頭と１行以上空行で空けてください。
空行を入れなかった場合、変数宣言行の後ろにコメントがあると、変数宣言行も関数ヘッダのコメントとして切り出されてしまいます。

---

関数ヘッダのコメントの途中に空行がある場合

int l_dat; // グローバルデータ //------------------------------------------------------------------------ // モジュールタイトル // ----------------------------------------------------------------------- // 入力：なし // 出力：なし // 戻り：0:OK -1:ERROR // --------------------------------------------------------------------- // 機能：モジュールの説明を記述 // //------------------------------------------------------------------------ // TEST用関数 int func1(void) {

関数ヘッダのコメントが空行により分割されている場合は、 空行以降のコメント（// TEST用関数）から切り出されます。
空行より上のコメントは、１つ前の関数に含まれてしまいます。
関数ヘッダのコメントを正しく切り出すには、 コメントとコメントの間に空行を入れないでください。

▲TOP

Copyright(C) Ciao-ware. All rights reserved.