Home
Extending HCL OneDB™Beyond standard relational database objects, HCL OneDB™ can be extended to handle specialized data types, access methods, routines, and other objects. HCL OneDB™ includes many built-in extensions that are fully integrated in the database server. HCL OneDB™ also provides DataBlade® modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for HCL OneDB™.
Creating extensionsYou can create user-defined data types, routines, access methods, and other database objects to suit your needs. You can use application programming interfaces to write user-defined routines and applications that access data in HCL OneDB™ databases.
DataBlade® API Function ReferenceThe HCL OneDB™ DataBlade® API Function Reference describes the DataBlade® API functions and the subset of functions that the DataBlade® API supports.
Function descriptionsThis section gives comprehensive reference information about the functions that are valid within DataBlade® API modules. It lists the function descriptions in alphabetical order, with syntax, usage information, and return values for the functions.
The bycmpr() functionThe bycmpr() function compares two groups of contiguous bytes for a given length. This function returns the result of the comparison.

The bycmpr() function

The bycmpr() function compares two groups of contiguous bytes for a given length. This function returns the result of the comparison.

Syntax

mint bycmpr(byte1, byte2, length)
   char *byte1;
   char *byte2;
   mint length;

byte1: A pointer to the location at which the first group of contiguous bytes starts.
byte2: A pointer to the location at which the second group of contiguous bytes starts.
length: The number of bytes to compare.

Usage

The bycmpr() function performs a byte-by-byte comparison of the two groups of contiguous bytes until it finds a difference or until it compares length number of bytes. The bycmpr() function returns an integer whose value (0, -1, or +1) indicates the result of the comparison between the two groups of bytes.

The bycmpr() function subtracts the bytes of the byte2 group from those of the byte1 group to accomplish the comparison.

Return values

0: The two groups are identical.
-1: The byte1 group is less than the byte2 group.
+1: The byte1 group is greater than the byte2 group.