Ets_Files_Diff_Generate()

注意: 需要 OPNET Development Kit

摘要

比较两个 ASCII 文件,并以 HTML 输出显示差异。

语法

Ets_Files_Diff_Generate (infile1_path, infile2_path, output_path, diff_options, num_of_diffs)
参数 类型 说明
infile1_path const char * 完整路径,包含文件名。
infile2_path const char * 完整路径,包含文件名。
output_path const char * 完整路径,包含文件名。输出文件为 HTML 文件。
diff_options EtsT_Files_Diff_Options * 格式化选项,见表 25。
num_of_diffs int * 发现的差异数量。
差异数量包含在 HTML 输出中。

返回类型

EtsT_Compcode

函数成功时返回 EtsC_Compcode_Success,失败时返回 EtsC_Compcode_Failure。

头文件

ets_api_diff.h

详情

该函数可用于比较两个 ASCII 文件。HTML 输出显示两个文件之间的差异。HTML 输出包括

  • HTML 头部
  • 说明差异符号与颜色的图例(新增、更改、删除)
  • 更改的数量 注意:连续的更改(例如多行被删除)计为一次更改。
  • 显示指定文件之间更改的两个窗格

EtsT_Files_Diff_Options 指定格式化特性。格式化选项列于下表。

表 25:EtsT_Files_Dif_Options—格式化选项

参数 类型 说明
ignore_white_space unsigned int 忽略空格和制表符。设为 1 以忽略空白字符,否则设为 0。
行尾的多余空格会被忽略。
注意:当忽略空白时,HTML 输出中连续的空格会被“折叠”为单个空格。因此输出可能与实际文件不完全一致。
strike_out_text unsigned int 对 file2 使用删除线文本,以指示存在于 file1 但不存在于 file2 的文本。设为 1 以使用删除线文本,否则设为 0。
context_lines_only unsigned int 仅显示差异及相应的上下文行。设为 1 以仅显示差异,否则设为 0。
对大文件执行差异比较时,使用该属性可节省时间(用于确定更改并渲染 HTML 输出。)
num_context_line int 差异上方和下方显示的上下文行数。与 context_lines_only 配合使用。默认值为 5。
show_progress unsigned int 在生成两个文件之间的差异时显示进度条。设为 1 以显示进度条,否则设为 0。
file1_title const char * 在输出中为 file1 显示的标题。
file2_title const char * 在输出中为 file2 显示的标题。
html_output_header_buffer‘ const char * 前置到输出的 HTML 头部。
error_log_buffer char * 用于记录错误的错误日志。
错误日志捕获可能出现的错误,包括无法定位指定文件或读/写权限问题。若产生错误,则不生成 HTML 输出。
len_error_log_buffer int 错误日志的长度。
注意:在将该缓冲区传入函数之前,必须先为其长度分配内存。
html_output_footer_buffer const char * 追加到输出的 HTML 尾部。

在使用 Ets_Files_Diff_Generate 函数之前,必须先为错误日志缓冲区的长度分配内存。

例如:

   /* Allocate error log buffer length */
   /* Allocate error log buffer length */
   char error_buffer[1024];
   /* Compare two ASCII files */
     char input_file1[] = "C;\users\jsmith\op_models\file1";
     char input_file2[] = "C;\users\jsmith\op_models\file2";
     char output_file[] = "C;\users\jsmith\op_models\output.html";
     int num_diffs;
     EtsT_Compcode retval;
   /* Perform file difference between file1 and file2 */
   EtsT_Files_Diff_Options options;
     options.ignore_white_space=0;
     options.strike_out_text=1;
     options.context_lines_only=1;
     options.num_context_line=5;
     options.show_progress=0;
     file1_title=”file1”;
     file2_title=”File2”;
     options.html_output_header_buffer=”<H2>File Differences:</H2>”;
     options.error_log_buffer=error_buffer;
     options.len_error_log_buffer=1024
     options.html_output_footer_buffer=”<H2>End of Output</H2>”;

   retval = Ets_Files_Diff_Generate
       (input_file1, input_file2, output_file, &options, &num_diffs);

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com