visdiff

2 つのファイルまたはフォルダーを比較

ページ内をすべて折りたたむ

構文

visdiff(filename1,filename2)
visdiff(filename1,filename2,type)
comparison = visdiff(___)

説明

visdiff(filename1,filename2) は比較ツールを開き、2 つのファイルまたはフォルダーの差異を表示します。比較ツールは、MATLAB® コード ファイル、zip ファイル、MAT ファイル、その他各種の MATLAB および Simulink® ファイル形式をサポートしています。完全な一覧については、入力引数を参照してください。

visdiff を使用して、2 つの Simulink モデルを比較して、変更を特定し、差異をマージします。詳細については、モデルの比較 (Simulink)を参照してください。

例

visdiff(filename1,filename2,type) は、指定した比較タイプを使用して、2 つのファイルを比較します。タイプを指定しない場合、visdiff は選択したファイルに既定の比較タイプを使用します。この構文を使用して、ファイルの比較のみを行うことができます。

例

comparison = visdiff(___) は 2 つのファイルを比較し、指定したファイルの差異が格納された comparison オブジェクトを返します。comparison オブジェクトは、フィルターの適用や比較レポートのパブリッシュなど、コマンド ラインで比較を操作するために使用します。この構文では比較ツールが開かず、表示は不要です。継続的インテグレーション (CI) ワークフローのための比較レポートの作成を自動化する場合に特に役立ちます。この構文は、一部のファイル タイプをサポートしていません。サポートされているファイルには、Simulink モデル、要件セット ファイル、リンク セット ファイル、プレーン テキスト ファイル、MATLAB スクリプト、MATLAB アプリ、およびテキストベースのソース コード ファイルがあります。

例

例

すべて折りたたむ

ライブ スクリプトを開く

この例では、相対パスと絶対パスを使用して 2 つのファイルを比較する方法を示します。

現在のフォルダーにある lengthofline.m と lengthofline2.m の 2 つのファイルを比較します。

visdiff("lengthofline.m","lengthofline2.m")

完全修飾ファイル名を使用して、gatlin.mat と gatlin2.mat の 2 つの MAT ファイルを比較します。

visdiff(fullfile(pwd,"supportingFiles","mymatFiles","gatlin.mat"), ...
fullfile(pwd,"supportingFiles","mymatFiles","gatlin2.mat"))
ライブ スクリプトを開く

lengthofline.m と lengthofline2.m の 2 つのファイルをバイナリとして比較します。

比較タイプを指定しない場合、visdiff は既定のテキスト比較タイプを使用して 2 つのファイルを比較します。バイナリ比較タイプに変更することで、行末の文字などの差異を調べることができます。 

visdiff("lengthofline.m","lengthofline2.m","binary")

Simulink モデルを比較する場合、出力引数を指定することにより、比較レポートをコマンド ラインで操作できます。

2 つのモデル ファイルを比較し、comparison オブジェクトを返します。

comparison = visdiff(modelname1,modelname2);

モデル比較レポートですべてのフィルターを無効にすることができます。

filter(comparison,"unfiltered");

比較レポートをファイルにパブリッシュするには、comparison オブジェクトに対して publish を使用します。パブリッシュされるレポートの既定の形式は HTML です。publish はこのファイルを filename1_filename2.html という名前で現在のフォルダーに保存します。

file = publish(comparison);
web(file)

myreport という名前の PDF 比較レポートを作成します。レポートを comparisonresults フォルダーに保存します。

file = publish(comparison,format="PDF",Name="myreport",OutputFolder="comparisonresults");
web(file)

サポートされるレポート形式は HTML、PDF、および DOCX です。

visdiff を使用して継続的インテグレーション ワークフローでレポートを生成する方法の説明については、Attach Model Comparison Report to GitHub Pull Requests (Simulink)を参照してください。

入力引数

すべて折りたたむ

ファイルまたはフォルダー名。文字ベクトルまたは string として指定します。filename には現在のフォルダーからの相対パスまたは絶対パスを含めることができます。

以下の表はサポートされるファイルの種類を示しています。

ファイルの種類ファイル拡張子
MATLAB
MATLAB コード ファイル.m
MATLAB ライブ コード ファイル.mlx, .m (R2025a 以降)
プレーン テキスト任意
テキストベースのソース コード.c、.cpp、.java など
MATLAB アプリ.mlapp
バイナリ任意
フォルダー 
ZIP ファイル.zip
MATLAB Figure.fig
MAT ファイル.mat
プロジェクト定義ファイル.xml
プロジェクト アーカイブ.mlproj
依存関係の GraphML.graphml
Simulink
Simulink モデル.slx, .mdl
Simulink モデル テンプレート.sltx
Simulink プロジェクト テンプレート.sltx
Simulink データ ディクショナリ.sldd
他の製品
Requirements Toolbox™.slreqx.詳細については、Create and Save Printable Reports of Comparison Results (Requirements Toolbox)を参照してください。
Requirements Toolbox リンク.slmx.詳細については、Create and Save Printable Reports of Comparison Results (Requirements Toolbox)を参照してください。
Simulink Test™.mldatx
SimBiology® モデル.sbproj
System Composer® モデル.slx
Simscape® ファイル.ssc

比較ツールを、.prj、.req、.cvf、.wrl、.x3s、.ssc、.xml、.tlc など、その他多くのファイル拡張子の基本的な比較に使用することもできます。

比較タイプ。"text" または "binary" として指定します。比較によっては、一部の比較タイプがサポートされません。サポートされていない比較タイプを指定した場合、MATLAB でエラーが表示されます。

テキスト ファイルの行末の文字などの差異を調べるには、比較タイプとして "binary" を指定します。

出力引数

すべて折りたたむ

コマンド ラインで比較を操作するための comparison オブジェクト。フィルターの適用や、比較レポートのパブリッシュなどを行います。サポートされているファイルには、Simulink モデル、プレーン テキスト ファイル、MATLAB スクリプト、MATLAB アプリ、およびテキストベースのソース コード ファイルがあります。

制限

  • MATLAB Online™ において、比較ツールはすべてのファイル タイプをサポートするわけではありません。サポートされるファイル タイプには、テキスト ファイル、MATLAB コード ファイル、フォルダー、zip ファイル、Simulink モデルなどが含まれます。

代替機能

比較ツールを対話的に開くことができます。

  • MATLAB エディター — MATLAB エディターまたはライブ エディターでファイルを開きます。エディターまたはライブ エディターのツールストリップで、[比較] 、 [比較対象] を選択します。次に、比較する対象のファイルを選択します。

    ファイルを自動保存バージョンまたはディスク上に保存されたバージョンと比較することもできます。[エディター] タブで、[比較] 、 [ディスク上のバージョンと比較] または [バックアップと比較] を選択します。ファイルが変更されている場合、エディターはファイルを保存してから比較します。[ディスク上のバージョンと比較] オプションと [バックアップと比較] オプションは、変更をファイルに自動的に保存するオプションが無効になっている場合にのみ使用できます。このオプションを無効にするには、[ホーム] タブに移動し、[環境] セクションで [設定] をクリックします。次に、[エディター/デバッガー] を選択し、[ファイル以外の場所をクリックしたときに変更を保存] をオフにします。このオプションは、ライブ エディターでは使用できません。

  • Simulink エディター — Simulink エディターで開いているモデルをディスク上の別のモデルと比較するには、[モデル化] タブの [実行と管理] セクションで [比較対象] をクリックします。

  • [ファイル] パネルまたは [プロジェクト] パネル — ディスク上の 2 つのファイルを比較するには、両方のファイルを選択します。次に、右クリックして [選択したファイル/フォルダーを比較] を選択します。比較ツールの左側に、最初に選択したファイルが表示されます。

バージョン履歴

R2008b で導入

すべて展開する

参考

トピック