dfCompare Function

Summary

dfCompare performs comparing of files, which are set by the comparing context and saves them in the context for further utilization upon df-file building using functions dfBuildN or dfBuildH.

Syntax

int dfCompare (

PTDfCmp
pCmp,

TDfCmpOptions *
pCmpOpt,

TDfInteract *
pInteract,

TDfCmpResult *
pCmpRes );

Arguments

pCmp

[Input]

Pointer on the comparing context.

pCmpOpt

[Input]

Pointer on the structure with comparing parameters (see description of the structure TDfCmp for details).

If NULL then default parameters values are taken.

pInteract

[Input]

Pointer on the structure of interaction with application program (see description of the structure TDfInteract for details).

Can be set NULL.

pCmpRes

[Output]

Contains the result of files comparing in case of successful execution of the function of field structure, which pCmpRes points on (see description of the structure TDfCmpResult for details).

Return Values

If the function succeeds, the return value is zero (EDF_SUCCESS).

If the function fails, the return value is one of the following:

• EDF_BAD_PARAM
• EDF_OUT_OF_MEMORY
• EDF_FATAL
• EDF_SYS_ERROR
• EDF_READ_ERROR
• EDF_ABORTED

Remarks

Function dfCompare can be called for an unlimited times with different parameters during all lifecycle of the comparing context.