測定結果概要

  測定結果は、CSV形式またはXML形式のどちらか一方を選択して出力することができます。

  - 測定の成否
  - 測定結果ファイルの形式
  - 測定結果ファイルの内容
  - 測定結果ファイル例

測定の成否

▲TOP

  本ソフトウェアの測定の成否は、測定コマンドの終了ステータスと測定ログで確認できます。終了ステータスは次のとおりです。

  終了ステータス | 測定コマンド戻り値
  正常終了 | 0
  異常終了 | -1 (マイナス1)

  正常終了
  - すべてのファイルが成功/失敗にかかわらず処理された場合
    (測定コマンドはファイル単位で失敗した場合は、継続して次のファイルを解析します。)

    ※ | ファイル単位の成功/失敗に関しては、測定結果ファイルに成功数および失敗数を出力します。

  - コマンドのヘルプ表示を行った場合
  異常終了
  以下のいずれかの事象が発生した場合(測定結果ファイルは正常に出力されません)
  - コマンドオプションが不正
  - インストール環境が不正
    - プロパティファイル内の"NKF"属性で値が"TRUE"かつ"NKFEXE"属性で値を指定しているが、指定したパスにNKFEXEが存在しない
    - プロパティファイル内の"BEAUTIFIER"属性で値が"TRUE"だが、指定したパスにBEAUTIFIEREXEが存在しない
    - プロパティファイル内の"JAVAEXE"属性で値を指定しているが、指定パスにJAVAEXEが存在しない
  - 入力ファイルリストの生成に失敗
  - プロパティファイルの読み込みに失敗
  - 測定結果ファイルのオープンに失敗
  - 本ソフトウェアが途中で中断された場合(CTRL+Cが押下され強制終了されるなど)

測定結果ファイルの形式

▲TOP

  測定結果ファイルは、CSV形式とXML形式のどちらか一方を選択して出力することができます。
  コマンドの"-F"オプションまたはプロパティファイルの"OUT_FORMAT"属性で形式を指定することができます。
  出力形式の指定がない場合、CSV形式で出力します。

  ファイル形式 | 説明 | 文字コード
  CSV形式 | 指定省略時、カレントフォルダーに"ncmeter.csv"ファイルが出力されます。 | 文字コードは指定可能です。※1
  XML形式 | -Tfoで測定結果ファイルパスを指定しない場合、カレントフォルダーに "ncmeter.xml"ファイルが出力されます。 | 文字コードはUTF-8(BOMなし)です。

  ※1 | "-Qrc"オプションおよびプロパティファイルの"CHARSET_OUT_CSV"属性で指定された文字コードで出力します。

  以降はCSV形式で説明を行います。

測定結果ファイルの形式

▲TOP

  測定結果ファイルの詳細を示します。
  測定結果ファイルは、測定種類にかかわらず「測定種類」「測定結果」「実行情報」から構成されます。
  各情報の内容を以下に示します。

  - 測定種類
  - 測定結果
  - 実行情報

[測定種類]

▲測定結果項目

  測定種類には測定時に選択した測定方法の情報が表示されます。
  以下に、測定種類の一覧を示します。

  測定内容 | 詳細
  Execute Mode | 測定種類 ROW ： 基本行数の測定 DIFF ： 差分行数 FILE ： 差分行数のファイル単位での測定 FUNC ： 差分行数の関数単位での測定 STRUCT ： 構造メトリクス 例) Execute Mode,DIFF,FILE

[測定結果]

▲測定結果項目

  測定の種類によって、出力される項目が異なります。

  項目名 | 説明 | 基本行数 | 差分行数 | 構造メトリクス
  --- | --- | --- | --- | ---
  DIR | 対象ファイルのフォルダーパス名 | ○ | ○ | ○
  FILE | 対象のファイル名 | ○ | ○ | ○
  FUNC | 対象の関数名 | ― | ○*3 | ○
  LANG | 対象の言語種別 | ○ | ○ | ○
  STMT | Statement count of code ステートメント数 | ○ | ― | ―
  TLOC | Total lines of code 総行数 | ○ | ○ | ―
  FLOC | Function lines of code 関数内の総行数 | ― | ― | ○
  ELOC | Effective lines of code 有効行数 | ○ | ○ | ○
  CLOC | Comment lines of code コメント行数 | ○ | ○ | ○
  BLOC | Blank lines of code 空白行数 | ○ | ○ | ○
  SKIP/MSKIP | Skip lines of code スキップ行数/Macro skip lines of code マクロスキップ行数 | ○ | ○ | ―
  ICLOC | Inline comment lines of code インラインコメント行数 | ○ | ○ | ―
  CODE | Compilation lines of code コンパイル行数 | ○ | ○ | ―
  PREP | Preprocess lines of code プリプロセス行数 | ○ | ○ | ―
  DOC | Specification comment lines of code 仕様コメント行数 | ○ | ○ | ―
  REM | General comment lines of code 一般コメント行数 | ○ | ○ | ―
  STATE | ソースコードファイルの差分属性 | ― | ○ | ―
  ADD_item*2 | ソースコードファイルの差分属性 | ― | ○ | ―
  DEL_item*2 | Deleted lines 削除行数。item ： ELOC、CLOCの各項目を出力します。 | ― | ○ | ―
  EQU_item*2 | Unmodified lines 無変更行数。item ： ELOC、CLOCの各項目を出力します。 | ― | ○ | ―
  MODADD_item*2 | Modified(added) lines 変更(追加)行数。item ： TOTAL、ELOC、CLOC、BLOC、SKIPの各項目を出力します。TOTALはELOC、CLOC、BLOC、SKIPの合計を出力します。 | ― | ○*1 | ―
  MODDEL_item*2 | Modified(deleted) lines 変更(削除)行数。item ： TOTAL、ELOC、CLOC、BLOC、SKIPの各項目を出力します。TOTALはELOC、CLOC、BLOC、SKIPの合計を出力します。 | ― | ○*1 | ―
  OLDDIR | オリジナルソースコードファイルのフォルダー | ― | ○ | ―
  OLDFILE | オリジナルソースコードファイル名 | ― | ○ | ―
  CYCLO | Cyclomatic complexity サイクロマティック数 | ― | ― | ○
  CYCLOWC | Cyclomatic complexity with cases サイクロマティック数(case含) | ― | ― | ○
  BRANCHS | Branch condition number 分岐条件数 | ― | ― | ○
  CNDOPS | Conditional Operators 三項演算子数 | ― | ― | ○
  NESTS | Maximum nesting level 最大ネスティング数 | ― | ― | ○

  ○：値を出力(ただし、言語種別やプロパティ設定等によってカウントされない場合がある)
  −：測定対象外の項目
  *1. DIFF_COUNT_MODE=STDの時のみカウント
  *2. DIFF_BLANKがFALSEの場合はBLOC項目に"-"が出力される
  *3. 関数単位の測定の場合のみカウント
  ※ 本バージョンでは下記の出力内容はサポートされていません。
  EVAR、EVALS、AVALS、PARMS、FANIN、FANOUT、FANIN_FUNC、FANIN_PARAM、FANIN_GVAL、FANOUT_FUNC、FANOUT_PARAM、FANOUT_GVAL

[実行情報]

▲測定結果項目

  実行情報には測定コマンド実行時の状況や処理対象のファイル数、測定処理の成功、失敗が表示されます。
  以下に、実行情報の一覧を示します。

  測定内容 | 詳細
  | Tool Name | ツール名※１
  Version | ツールバージョン情報
  Start Date | 開始日時
  End Date | 終了日時
  Command Parameter | コマンド実行時のオプション情報※１
  Property File Name | 読み込んだプロパティファイル名※１
  Output STYLE | 整形しない(RESTYLE NONE)／整形する(RESTYLE STD)／両方(RESTYLE BOTH)
  Output DOC | 仕様コメント行数カウント有無(TRUE, FALSE)
  Output DEF | 常にFALSE。本バージョンではサポートされない
  Output SKIP | SKIP/MSKIPの測定方式NEW, OLD)
  Output DIFF_BLANK | 差分行数での空白の扱いを指定(TRUE, FALSE)
  Output DIFF_COUNT_MODE | 差分行数の測定内容を指定(STD, EXT)
  total number of Files | 処理対象ファイル数(拡張子がカウント対象となるファイル)
  success number of Files | カウント成功ファイル数
  error number of Files | カウント失敗ファイル数(処理継続できないエラーが発生したファイル)

  ※1 | 出力内容に多国語が含まれる場合、"-Qrc"オプションでUTF-8を指定することにより多国語の文字を出力できます。

測定結果ファイル例

▲TOP

  以下は、CSV形式で出力した測定結果ファイルをExcelで表示した例です。

  図中の赤枠部分は、以下の情報を出力しています。

  - A ： 測定種類
  - B ： 測定結果
  - C ： 実行情報