Main Content

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
ライブ スクリプト.mlx
プレーン テキスト任意
テキストベースのソース コード.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" または "xml" として指定します。比較によっては、一部の比較タイプがサポートされません。サポートされていない比較タイプを指定した場合、MATLAB でエラーが表示されます。

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

XML ファイルの既定の比較タイプは、XML の種類によって異なり、"text" と "xml" のいずれかです。"text" または "xml" を指定して、ファイルの既定の比較タイプをオーバーライドします。

出力引数

すべて折りたたむ

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

制限

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

代替機能

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

  • MATLAB [ホーム] タブ — [ファイル] セクションで、[比較] をクリックします。次に、比較するファイルまたはフォルダーを選択します。

  • 現在のフォルダー ブラウザー — ファイルまたはフォルダーを比較するには、選択したファイルまたはフォルダーを右クリックして、[比較対象を指定] を選択します。2 つのファイルまたはフォルダーを比較するには、選択した 2 つのファイルまたはフォルダーを右クリックして、[選択したファイル/フォルダーを比較] を選択します。

  • MATLAB の [エディター] タブまたは [ライブ エディター] タブ — エディターで開いているファイルを比較するには、[ファイル] セクションで [比較] をクリックします。

  • MATLAB [エディター] タブ — ファイルを自動保存バージョンまたはディスク上に保存されたバージョンと比較するには、[ファイル] セクションで [比較] を展開し、[ディスク上のバージョンと比較] または [自動保存機能による保存および比較] を選択します。ファイルを変更した場合、エディターはファイルを保存してから比較します。[ディスク上のバージョンと比較] オプションと [自動保存機能による保存および比較] オプションは、変更の自動保存を無効にした場合にのみ使用できます。これを行うには、[ホーム] タブに移動し、[環境] セクションの [基本設定] をクリックします。次に、[エディター/デバッガー] を選択し、[ファイル以外の場所をクリックしたときに変更を保存] をオフにします。

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

バージョン履歴

R2008b で導入

すべて展開する

参考

トピック