exponenta event banner

visdiff

Сравнение двух файлов или папок

Описание

пример

visdiff(name1,name2) отображает различия между двумя указанными файлами или папками в средстве сравнения. Инструмент сравнения файлов поддерживает множество типов файлов, таких как файлы кода MATLAB ®, zip-файлы, MAT-файлы и различные другие форматы файлов MATLAB и Simulink ®.

Использовать visdiff для сравнения двух моделей Simulink и определения изменений или объединения различий между моделями. Дополнительные сведения см. в разделе Сравнение моделей (Simulink).

пример

visdiff(name1,name2,type) сравнивает два файла или папки с использованием указанного типа сравнения. Если тип не указан, visdiff использует тип сравнения по умолчанию для выбранных файлов. type не применяется при сравнении папок.

пример

comparison=visdiff(___) сравнивает два файла модели и возвращает объект сравнения, содержащий различия между этими двумя файлами. Этот синтаксис не открывает инструмент сравнения и поддерживается только для сравнения моделей Simulink. name1 и name2 должны быть файлами модели. Объект сравнения используется для управления сравнением в командной строке, например, путем применения фильтров и публикации отчетов сравнения.

Примеры

свернуть все

Сравнение двух файлов с использованием относительных и полных путей.

Сравнение двух файлов lengthofline.m и lengthofline2.m в текущей папке.

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

Сравнение двух демонстрационных файлов gatlin.mat и gatlin2.mat с использованием полного имени файла.

visdiff(fullfile(matlabroot,'toolbox','matlab','demos','gatlin.mat'), ...
fullfile(matlabroot,'toolbox','matlab','demos','gatlin2.mat'))

Сравнение двух файлов lengthofline.m и lengthofline2.m как двоичный.

Если тип не указан, visdiff сравнивает два файла с использованием типа сравнения текста по умолчанию. При переходе к бинарному типу сравнения можно исследовать различия, такие как символы конца строки.

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

При сравнении моделей Simulink можно управлять сравнением в командной строке, указав выходной аргумент для visdiff.

Сравнение двух файлов модели и получение выходных данных объекта сравнения из visdiff.

comparison = visdiff(modelname1, modelname2);

(Необязательно) Фильтрация результата сравнения. Поддерживаются следующие фильтры: 'unfiltered' - удаляет всю фильтрацию из сравнения, или 'default' - стратегия фильтрации по умолчанию для сравнений.

filter(comparison, 'unfiltered');

Чтобы опубликовать отчет о сравнении в файле, используйте publish на объекте сравнения. Формат опубликованного отчета по умолчанию - HTML. publish сохраняет файл в текущей папке как filename1_filename2.html.

file = publish(comparison);
web(file)

Чтобы указать параметры для отчета, используйте следующие пары имя-значение с publish.

  • 'Format' - Формат файла опубликованного отчета.

    Возможны следующие варианты: 'html' (по умолчанию) - однофайловый HTML-документ, 'docx' - документ Microsoft ® Word или'pdf' – PDF document.

  • 'Name' - название отчета.

    Символьный вектор или скалярный строковый массив. Если указано расширение файла, то 'Format' игнорируется.

  • 'OutputFolder' - Где сохранить отчет.

    Символьный вектор или скалярный строковый массив. По умолчанию используется текущая папка.

Можно также указать пары имя-значение в options структура: publish(comparison, options).

Входные аргументы

свернуть все

Имя файла или папки для сравнения, указанное как символьный вектор. name может включать относительный путь, но относительный путь должен находиться в текущей папке. В противном случае name должен содержать полный путь.

Тип сравнения, указанный как 'text', 'binary', или 'xml'. Некоторые сравнения не поддерживают все типы сравнения. Если указан неподдерживаемый тип сравнения, MATLAB отображает ошибку.

Чтобы проверить различия, такие как символы конца строки в текстовых файлах, укажите 'binary' тип сравнения.

Тип сравнения по умолчанию для XML-файлов зависит от типа XML. 'text' или 'xml'. Определить 'text' или 'xml' для переопределения типа сравнения по умолчанию для файла.

Выходные аргументы

свернуть все

Объект сравнения для управления сравнением в командной строке, например, путем применения фильтров и публикации отчетов сравнения. Поддерживается только для сравнения моделей Simulink.

Ограничения

MATLAB Online™ поддерживает только сравнение текстовых файлов и файлов кода MATLAB. Другие типы файлов, такие как zip-файлы, MAT-файлы и модели Simulink, в настоящее время не поддерживаются.

Совет

В некоторых случаях для выбора может быть доступно несколько типов сравнения (например, текст, двоичный файл, список файлов или сравнение XML). Чтобы выбрать другой тип сравнения, используйте visdiff и укажите type аргумент. Можно также выбрать один из доступных типов сравнения в инструменте сравнения. Дополнительные сведения см. в разделах Сравнение файлов и папок и Объединение файлов.

Альтернативная функциональность

В качестве альтернативы visdiff используйте инструмент сравнения для интерактивного сравнения файлов или папок. Чтобы открыть инструмент сравнения, перейдите на вкладку Главная (Home) и в разделе Файл (File) щелкните Сравнить (Compare). Затем выберите файлы или папки для сравнения.

Можно также сравнить файл, открытый в редакторе. На вкладке Редактор (Editor) или Интерактивный редактор (Live Editor) в разделе Файл (File) выберите Сравнить (Compare).

Чтобы сравнить файл с версией автосохранения или сохраненной версией на диске, перейдите на вкладку Редактор (Editor), щелкните Сравнить (Compare) и выберите Сравнить с версией на диске (Compare with Version on Disk) или Сохранить и сравнить с автосохранением (Save and Compare with Autosave). Если файл изменен, редактор сохраняет файл перед сравнением. Опции Сравнить с версией на диске (Compare with Version on Disk) и Сохранить и сравнить с автосохранением (Save and Compare with Autosave) доступны только в том случае, если опция автоматического сохранения изменений в файле отключена. Чтобы отключить этот параметр, перейдите на вкладку Главная (Home) и в разделе Среда (Environment) щелкните Настройки (Preferences). Затем выберите Редактор/Отладчик (Editor/Debugger) и снимите флажок Сохранить изменения (Save changes) при щелчке в стороне от файла.

Чтобы сравнить файл или папку в браузере «Текущая папка», щелкните правой кнопкой мыши выбранный файл или папку и выберите «Сравнить с». Чтобы сравнить два файла или подпапки, щелкните правой кнопкой мыши выбранные файлы или папки и выберите Сравнить выбранные файлы/папки.

Представлен в R2008b