機能概要

  source code metrics counter はソースコードの規模や複雑度などを測定するツールです。
  本ソフトウェアの概要を以下に示します。
  - 提供機能
  - 測定方法
  - 測定結果
  - 対象言語
  - 文字コードについて
  - 実行環境

  注： | 本マニュアルで使用するソフトウェアやアプリケーションなどの名前は略称を用いている場合があります。 正式名称との対応関係については、 「名称について」 を参照してください。

提供機能

▲TOP

  本ソフトウェアは、以下のツールを提供します。

  - 測定コマンド
    ソースコードメトリクスを測定するコマンドです。バッチ実行などで利用可能です。
  - GUIツール
    GUIからソースコードメトリクスを測定するツールです。
  - 帳票作成支援ツール
    測定結果ファイルをわかりやすく表示し基準値チェックが行える、Excel上で動作するツールです。

測定方法

▲TOP

  本ソフトウェアが測定できるメトリクスは次のとおりです。
  - 基本行数
    ファイルの有効行数やコメント行数、空白行数などを測定します。
    ファイル単位で測定します。
  - 差分行数
    オリジナルと変更後のファイルを比較し、無変更、追加、削除、変更行数を測定します。
    ２種類の測定方法を指定することができます。
    - ファイル単位の測定
      差分行数をファイル単位で測定します。
    - 関数単位の測定
      差分行数を関数単位で測定します。
      C/C++言語のソースコードのファイルのみ対応しています。
  - 構造メトリクス
    プログラムの複雑さを測定します。
    関数単位で測定します。
    ソースコードのファイルを解析し、構文構造の複雑さを測定します。
    測定対象のファイルは、コンパイルしてエラーが出ない状態であることが必要です。

測定結果

▲TOP

  測定結果は、CSV形式またはXML形式で出力することができます。

  - 1回の測定で1ファイルを出力します。
  - 測定結果はファイルまたは関数単位で出力します。
  - 対象ファイルの言語種別の情報を出力します。

  ツール実行時の状況や測定処理の成功、失敗をログに表示します。

対象言語

▲TOP

  本ソフトウェアの対象言語は以下のとおりです。
  測定の種類によって使用できる言語が異なります。

  言語種類 | 基本行数 | 差分行数 | 構造メトリクス
  C/C++ | ○ | ○ | ○
  Java | ○ | ○ | ○
  C# | ○ | ○ | ○
  Visual Basic | ○ | ○ | ○
  JavaScript | ○ | ○ | ○
  テキストファイル ※1 | ○ | ○ | ×
  そのほかのテキスト形式スクリプト・ソースコード ※2 | ○ | ○ | ×

  ※1 | 本ソフトウェアのインストール直後の状態では、測定対象外の状態で定義されています。 プロパティファイルの設定を変更してから測定してください。
  ※2 | 測定対象とするためには、プロパティファイルに定義を追加する必要があります。 本ソフトウェアのインストール直後の状態で、いくつかの言語については定義が登録されています。

  構造メトリクスを測定する場合は、各言語仕様のバージョンにしたがって解析を行います。
  下記以外のバージョンのソースコードを測定した場合、測定結果が出力されない、あるいは測定結果が正しくないことがあります。

  C/C++ | C ISO/IEC 9899:1999 C++ ISO/IEC 14882:2003
  Java | The Java® Language Specification, Java SE 8 Edition (Java 8)
  C# | C# Language Specification 4.0 ECMA-334 4th Edition / June 2006 (Microsoft® Visual Studio® 2010に対応)
  Visual Basic言語 | The Microsof® Visual Basic® Language Specification Version 8.0 (Microsoft® Visual Studio® 2005に対応)
  JavaScript言語 | JavaScript 1,7　ECMA-262 3rd Edtition

文字コードについて

▲TOP

  - 測定対象のソースコード
    本ソフトウェアで測定できるファイルの文字コードは、JISコード(ISO-2022-JPに基づくもの)、Shift_JIS(MS 漢字コード)、 日本語 EUC (AT&Tコード)、UTF-8、UTF-16のいずれかです。
    本ソフトウェアの測定では、対象のソースコードのファイルは、nkf(ネットワーク用漢字コード変換フィルタ)を利用して、UTF-8に変換し測定します。
    ソースコードのファイルがUTF-8のみの場合は、nkfを利用しない設定にできます。
  - 出力するファイル
    出力する測定結果ファイルや測定ログの文字コードは、オプションで指定できます。
    インストールした直後の状態では、OSのシステムコードページにしたがった文字コードで出力します。

実行環境

▲TOP

  - 対象OS
    本ソフトウェアの対象OSは以下のとおりです。
    - Windows® 8.1 Pro
  - 必要なソフトウェア
    本ソフトウェアを利用するには、以下のソフトウェアが必要となります。

    ソフトウェア | 用途
    Microsoft® .Net Framework 4 | C#言語の構造メトリクスの測定 GUIツールの実行
    Java™ SE Runtime Environment (JRE) 7 あるいは Java™ SE Runtime Environment (JRE) 8 | Java言語、JavaScript言語の構造メトリクスの測定
    Microsoft® Excel® | 帳票作成支援ツール