Comparison Functions
[C Runtime Common Functions]

Functions

OSBOOL rtCmpBoolean (const char *name, OSBOOL value, OSBOOL compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpInt8 (const char *name, OSINT8 value, OSINT8 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpSInt (const char *name, OSINT16 value, OSINT16 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpUInt8 (const char *name, OSUINT8 value, OSUINT8 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpUSInt (const char *name, OSUINT16 value, OSUINT16 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpInteger (const char *name, OSINT32 value, OSINT32 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpUnsigned (const char *name, OSUINT32 value, OSUINT32 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpInt64 (const char *name, OSINT64 value, OSINT64 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpUInt64 (const char *name, OSUINT64 value, OSUINT64 compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpBitStr (const char *name, OSUINT32 numbits, const OSOCTET *data, OSUINT32 compNumbits, const OSOCTET *compData, char *errBuff, int errBuffSize)
OSBOOL rtCmpOctStr (const char *name, OSUINT32 numocts, const OSOCTET *data, OSUINT32 compNumocts, const OSOCTET *compData, char *errBuff, int errBuffSize)
OSBOOL rtCmpCharStr (const char *name, const char *cstring, const char *compCstring, char *errBuff, int errBuffSize)
OSBOOL rtCmp16BitCharStr (const char *name, Asn116BitCharString *bstring, Asn116BitCharString *compBstring, char *errBuff, int errBuffSize)
OSBOOL rtCmp32BitCharStr (const char *name, Asn132BitCharString *bstring, Asn132BitCharString *compBstring, char *errBuff, int errBuffSize)
OSBOOL rtCmpReal (const char *name, OSREAL value, OSREAL compValue, char *errBuff, int errBuffSize)
OSBOOL rtCmpOID (const char *name, ASN1OBJID *pOID, ASN1OBJID *pcompOID, char *errBuff, int errBuffSize)
OSBOOL rtCmpOIDValue (const char *name, ASN1OBJID *pOID, ASN1OBJID *pcompOID, char *errBuff, int errBuffSize)
OSBOOL rtCmpOID64 (const char *name, ASN1OID64 *pOID, ASN1OID64 *pcompOID, char *errBuff, int errBuffSize)
OSBOOL rtCmpOID64Value (const char *name, ASN1OID64 *pOID, ASN1OID64 *pcompOID, char *errBuff, int errBuffSize)
OSBOOL rtCmpOpenType (const char *name, OSUINT32 numocts, const OSOCTET *data, OSUINT32 compNumocts, const OSOCTET *compData, char *errBuff, int errBuffSize)
OSBOOL rtCmpOpenTypeExt (const char *name, OSRTDList *pElemList, OSRTDList *pCompElemList, char *errBuff, int errBuffSize)
OSBOOL rtCmpTag (const char *name, int tag, int compTag, char *errBuff, int errBuffSize)
OSBOOL rtCmpSeqOfElements (const char *name, int noOfElems, int compNoOfElems, char *errBuff, int errBuffSize)
OSBOOL rtCmpOptional (const char *name, unsigned presentBit, unsigned compPresentBit, char *errBuff, int errBuffSize)

Detailed Description

The group of functions allows comparing the values of primitive ASN.1 types. These functions are used in the comparison routines that are generated by the ASN1C complier when the -gencompare option is used.

Information on elements that do not match is written to the given error buffer for each function. This makes it possible to compare complex structures and get back specific information as to what elements within those structures are different.

Function Documentation

OSBOOL rtCmp16BitCharStr ( const char *  name,
Asn116BitCharString *  bstring,
Asn116BitCharString *  compBstring,
char *  errBuff,
int  errBuffSize 
)

The rtCmp16BitCharStr function compares two ASN.1 16-bit character string values (including BMPString).

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
bstring The pointer to the first 16-bit character string structure to compare.
compBstring The pointer to the second 16-bit character string structure to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmp32BitCharStr ( const char *  name,
Asn132BitCharString *  bstring,
Asn132BitCharString *  compBstring,
char *  errBuff,
int  errBuffSize 
)

The rtCmp32BitCharStr function compares two 32-bit character string values (including UniversalString).

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
bstring The pointer to the first 32-bit character string structure to compare.
compBstring The pointer to the second 32-bit character string structure to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpBitStr ( const char *  name,
OSUINT32  numbits,
const OSOCTET *  data,
OSUINT32  compNumbits,
const OSOCTET *  compData,
char *  errBuff,
int  errBuffSize 
)

The rtCmpBitStr function compares two ASN.1 BIT STRING values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
numbits The number of bits in the first value to compare.
data The pointer to the data of the first value to compare.
compNumbits The number of bits in the second value to compare.
compData The pointer to the data of the second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpBoolean ( const char *  name,
OSBOOL  value,
OSBOOL  compValue,
char *  errBuff,
int  errBuffSize 
)

The rtCmpBoolean function compares two ASN.1 Boolean values. The return value is TRUE (matched) or FALSE (unmatched).

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
value First value to compare.
compValue Second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpCharStr ( const char *  name,
const char *  cstring,
const char *  compCstring,
char *  errBuff,
int  errBuffSize 
)

The rtCmpCharStr function compares two ASN.1 8-bit character sting values (including IA5String, VisibleString, PrintableString, NumericString, etc.)

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
cstring The first standard null-terminated string to compare.
compCstring The second standard null-terminated string to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpInt64 ( const char *  name,
OSINT64  value,
OSINT64  compValue,
char *  errBuff,
int  errBuffSize 
)

The rtCompInt64 function compares two 64-bit ASN.1 INTEGER values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
value First value to compare.
compValue Second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpInteger ( const char *  name,
OSINT32  value,
OSINT32  compValue,
char *  errBuff,
int  errBuffSize 
)

The rtCmpInteger function compars two ASN.1 INTEGER values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
value First value to compare.
compValue Second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpOctStr ( const char *  name,
OSUINT32  numocts,
const OSOCTET *  data,
OSUINT32  compNumocts,
const OSOCTET *  compData,
char *  errBuff,
int  errBuffSize 
)

The rtCmpOctStr function compares two ASN.1 OCTET STRING values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
numocts The number of the octets in the first value to compare.
data The pointer to the data of the first value to compare.
compNumocts The number of the octets in the second value to compare.
compData The pointer to the data of the second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpOID ( const char *  name,
ASN1OBJID *  pOID,
ASN1OBJID *  pcompOID,
char *  errBuff,
int  errBuffSize 
)

The rtCmpOID function compares two ASN.1 OBJECT IDENTIFIER or REALTIVE-OID values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
pOID The pointer to the first value to compare.
pcompOID The pointer to the second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpOID64 ( const char *  name,
ASN1OID64 *  pOID,
ASN1OID64 *  pcompOID,
char *  errBuff,
int  errBuffSize 
)

The rtCmpOID64 function compares two 64-bit ASN.1 OBJECT IDENTIFIER or RELATIVE-OID values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
pOID The pointer to the first value to compare.
pcompOID The pointer to the second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpOpenType ( const char *  name,
OSUINT32  numocts,
const OSOCTET *  data,
OSUINT32  compNumocts,
const OSOCTET *  compData,
char *  errBuff,
int  errBuffSize 
)

The rtCmpOpenType function compares two ASN.1 values of the old (pre- 1994) ASN.1 ANY type or other elements defined in the later standards to be Open Types (for example, a variable type declaration in a CLASS construct defined in X.681).

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
numocts The number of octets in the first value to compare.
data The pointer to the data of the first value to compare.
compNumocts The number of octets in the second value to compare.
compData The pointer to the data of the second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpOpenTypeExt ( const char *  name,
OSRTDList *  pElemList,
OSRTDList *  pCompElemList,
char *  errBuff,
int  errBuffSize 
)

The rtCmpOpenTypeExt function compares two ASN.1 open type extension values.

An open type extension is defined as an extensibility marker on a constructed type without any extension elements defined (for example, SEQUENCE {a INTEGER, ...}). The difference is that this is an implicit field that can span one or more elements whereas the standard Open Type is assumed to be a single tagged field.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
pElemList The first pointer to a linked list structure. The list should consist of ASN1OpenType elements.
pCompElemList The second pointer to a linked list structure. The list should consist of ASN1OpenType elements.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpReal ( const char *  name,
OSREAL  value,
OSREAL  compValue,
char *  errBuff,
int  errBuffSize 
)

The rtCmpReal function compares two ASN.1 REAL values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
value First value to compare.
compValue Second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpUInt64 ( const char *  name,
OSUINT64  value,
OSUINT64  compValue,
char *  errBuff,
int  errBuffSize 
)

The rtCmpUInt64 function compares two 64-bit ASN.1 unsigned INTEGER values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
value First value to compare.
compValue Second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.
OSBOOL rtCmpUnsigned ( const char *  name,
OSUINT32  value,
OSUINT32  compValue,
char *  errBuff,
int  errBuffSize 
)

The rtCmpUnsigned function compares two ASN.1 unsigned INTEGER values.

Parameters:
name The name of value. Used for constructing errBuff if values are not matching.
value First value to compare.
compValue Second value to compare.
errBuff The pointer to the buffer to receive the null-terminated string if the comparison fails. If the comparison failed, this buffer will contain the null-terminated string that explains the reason of comparison failure.
errBuffSize The size of the errBuff buffer.
Returns:
The comparison result. TRUE, if values matched, otherwise FALSE.