| Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions |
|
|
The mi_get_int8() function copies an mi_int8 (INT8) value, converting any difference in alignment or byte order on the client computer to that of the server computer.
| data_ptr | is a pointer to the buffer from which the mi_int8 value is to be copied. |
| int8_ptr | is a pointer to the buffer to which the mi_int8 value is to be copied. |
The mi_get_int8() function copies a value from the user-defined buffer that data_ptr references into the mi_int8 value that int8_ptr references. Upon completion, mi_get_int8() returns the address of the position within the buffer to which data can be copied. The function advances the returned address by n bytes, ready for a subsequent copy. In other words, if n is the length of the value that int8_ptr identifies, the returned address is n bytes advanced from the original buffer address in data_ptr.
The mi_get_int8() function is useful in a receive support function of an opaque data type that contains mi_int8 values. Use this function to receive an aligned 8-byte integer (INT8) value from a client application, which possibly has unaligned data buffers.
| mi_unsigned_char1 * | is the new address in the data_ptr data buffer. |
| NULL | indicates that the function was not successful. |
See the description of the following functions: mi_get_bytes(), mi_get_date(), mi_get_datetime(), mi_get_decimal(), mi_get_double_precision(), mi_get_integer(), mi_get_interval(), mi_get_lo_handle(), mi_get_money(), mi_get_real(), mi_get_smallint(), mi_get_string(), and mi_put_int8().
For more information on the use of mi_get_int8() in a receive support function, see Converting Opaque-Type Data With Machine-Specific Data Types.