MatchUp Object:Hybrid:Comparison

← MatchUp Object Reference

Use the following functions to determine how much of each match key will be used to select records for the cluster and compare the input data to the keys in the cluster.

GetKeySize

This function returns an integer value indicating the number of characters in a key generated using the matchcode selected using the SetMatchcodeName function.

This function can be useful for determining field sizes or how much memory will need to be allocated, if the programming language requires the developer to handle memory management.

Syntax	int = mdMU->GetKeySize()
C	int = mdMUHybridGetKeySize(mdMU)
.Net	integer = mdMU.GetKeySize

GetClusterSize

This function returns an integer value indicating the maximum size of the portion of the match key that can be used for clustering.

Use this function to determine how much of the key to use for comparison when building the cluster file, a subset of keys from your master database.

Syntax	int = mdMU->GetClusterSize()
C	int = mdMUHybridGetClusterSize(mdMU)
.Net	integer = mdMU.GetClusterSize

CompareKeys

This function compares two match keys and returns a long integer value indicating whether they match.

If this function does not find a match, the return value will be zero. If there was a match, this function returns an unsigned long integer value indicating which combination or combinations within the matchcode produced the match.

Each bit of the integer value matches a specific combination. Use a logical AND operation to determine if a particular combination produced the match. For example:

IF (mdMU->GetCombination AND 0x8000)
  THEN Print "Combo 16 Matched"

Although this function does not return an enumerated value, it does use the same values as the MatchcodeCombination enumeration used by the Matchcode Editing interface.

For a list of these enumerations, see Matchcode Combinations Enumerations.

This function does not return any information about dupe groups or the number of duplicate records. This is because the Hybrid interface does not keep track of matching records (it is up to you to do this).

Syntax	long = mdMU->CompareKeys()
C	long= mdMUHybridCompareKeys(mdMU)
.Net	long = mdMU.CompareKeys

GetResults

This function returns a comma-delimited string of four-character codes that detail the output disposition of the last call to the CompareKeys function. It will also contain the result code of any matchcode combination which contributed to the present record matching other records in its dupe group.

This function is intended to add new functionality of a returned Status Code and matchcode Combinations previously available by evaluating the CompareKeys return value, providing a single source of information about the last CompareKeys function call, and eliminating the need to perform bitwise operations on the return value to determine which matchcode combinations contributed to the record matching the other match key.

The function returns one or more of the MatchUp Object Result Codes in a comma-delimited list.

Syntax	StringValue = object->GetResults();
C	StringValue = mdMatchUpGetResults(object);
.Net	StringValue = object.GetResults