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);