ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

codeCompatibilityReport

コードの互換性レポートの作成

構文

codeCompatibilityReport
codeCompatibilityReport(names)
codeCompatibilityReport(___,'IncludeSubfolders',tf)
codeCompatibilityReport(cca)

説明

codeCompatibilityReport は、現在の作業フォルダーとサブフォルダーについてコードの互換性レポートを作成します。コードの互換性レポートは、MATLAB® Web ブラウザーに開きます。MATLAB の新しいバージョンにアップグレードした後、このレポートを使用して、既存のコードの潜在的な互換性の問題を特定できます。

codeCompatibilityReport(names) は、names で指定されたファイルまたはフォルダーのレポートを作成します。

codeCompatibilityReport(___,'IncludeSubfolders',tf) は、サブフォルダーについてレポートするかどうかを指定します。既定では、サブフォルダーは解析に含まれます。この構文は、前述の構文にある任意の引数を指定して使用します。

codeCompatibilityReport(cca) は、CodeCompatibilityAnalysis オブジェクトとして指定された既存のコードの互換性結果からレポートを作成します。

すべて折りたたむ

現在のフォルダーとサブフォルダー内のコードについて、コードの互換性レポートを作成します。レポートは MATLAB Web ブラウザーに開きます。

codeCompatibilityReport

別のレポートを作成します。ただし、解析からサブフォルダーを除外します。

codeCompatibilityReport('IncludeSubfolders',false)

現在の作業フォルダーとサブフォルダー内のコードについて、互換性解析結果を生成します。

r = analyzeCodeCompatibility;

その結果からレポートを作成します。レポートは MATLAB Web ブラウザーに開きます。

codeCompatibilityReport(r)

入力引数

すべて折りたたむ

解析するファイルまたはフォルダーの名前。文字ベクトル、文字ベクトルの cell 配列、string スカラーまたは string 配列として指定します。

ファイルの名前は有効な MATLAB コード ファイルまたはアプリ ファイル (.m.mlx または .mlapp) でなければなりません。

例: '../thisFile.m'

例: {'folderA','folderB','fileA'}

データ型: char | string

サブフォルダーの解析インジケーター。truefalse、0 または 1 として指定します。既定では、analyzeCodeCompatibility は解析にサブフォルダーを含めます。サブフォルダーを除外するには、tffalse または 0 に設定します。

コード互換性解析の結果。CodeCompatibilityAnalysis オブジェクトとして指定します。

詳細

すべて折りたたむ

コードの互換性レポート

コードの互換性レポートには、MATLAB の新しいバージョンへのコードのアップグレードに役立つ情報が含まれています。次のセクションがあります。

  • 構文エラー—構文エラーの詳細を示す表。たとえば、"~ を使用して値を無視することは、このコンテキスト内で許可されていません" があります。構文エラーによってコードは実行不能になります。構文エラーは MATLAB の新しいバージョンでは発生しませんが、互換性の解析に影響を与えます。この表には次の情報が含まれています。

    レポートの列説明
    解析されたコード内で検出された問題の順序付きリスト。
    ファイル名フラグの設定されたチェックを含むファイルの名前。
    ファイル内でチェックにフラグが設定された位置を示す行番号。

    説明

    チェックの説明。説明は、コード アナライザー メッセージと同じです。

    詳細

    ドキュメンテーション内の詳細情報へのリンク。

  • 非互換性エラー—解析されたコード内の非互換性エラーの詳細を示す表。例: "'wavfinfo' は削除されました。代わりに 'AUDIOINFO' を使用してください。"この表には、[構文エラー] セクションと同じ列が含まれます。

  • 非互換性の警告—非互換性の警告の詳細を示す表。例: "'aviinfo' は将来のリリースで削除される予定です。代わりに 'VideoReader' を使用してください。"この表には、[構文エラー] セクションと同じ列が含まれます。

  • 推奨される改善—コードの改善の余地を示す表。例: "プログラムでの DISPLAY の使用は推奨されません。代わりに DISP または FPRINTF を使用してください。"この表には、[構文エラー] セクションと同じ列が含まれます。

  • 実行されたチェック—特定のコードで実行されたチェックの詳細。次の情報が含まれています。

    レポートの列説明

    発生

    解析されたコード内で、特定のチェックにフラグが設定された合計回数。

    ファイル

    解析されたコード内で、特定のチェックにフラグが設定されたファイル数。

    説明

    チェックの説明。たとえば、"このステートメントの前に、改行、セミコロンまたはコンマを使用してください"、または "STRMATCH は推奨されません。代わりに STRNCMP または VALIDATESTRING を使用してください" があります。説明は、コード アナライザー メッセージと同じです。

    重大度

    チェックの重大度。たとえば、エラー警告があります。エラーには、構文エラー、またはサポートの終了した機能が使用されていることを示すものがあります。警告には、コードに改善の余地があることを示すものがあります。

    識別子

    MATLAB コード アナライザー メッセージの識別子。

    詳細

    ドキュメンテーション内の詳細情報へのリンク。

  • ファイル—MATLAB がコードの互換性を解析したファイルのリスト。

ヒント

  • レポートを保存するには、関数 codeCompatibilityReport を使用してレポートを生成する代わりに、CodeCompatibilityAnalysis オブジェクトを作成してそれを保存することができます。その後、これらの保存結果からレポートを生成できます。詳細については、既存の解析結果のレポートを作成を参照してください。

代替方法

現在のフォルダー ブラウザーで、現在の作業フォルダーとサブフォルダー内のコードに関するコードの互換性レポートを生成します。現在のフォルダー ブラウザーで、 をクリックするか、空白の領域を右クリックします。次に [レポート][コードの互換性レポート] を選択します。MATLAB コードの互換性レポートを参照してください。

R2017b で導入