Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_put_bytes() function copies the given number of bytes, converting any difference in alignment or byte order on the server computer to that of the client computer.

mi_unsigned_char1 *mi_put_bytes (data_ptr, val_ptr, nbytes)

mi_unsigned_char1 *data_ptr;

char *val_ptr;

mi_integer nbytes;

data_ptr	is a pointer to the buffer to which to copy bytes.
val_ptr	is a pointer to the buffer from which to copy bytes.
nbytes	is the number of bytes to copy.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
No	Yes

The mi_put_bytes() function copies nbytes bytes from the user-defined buffer that data_ptr references into the value that val_ptr references. Upon completion, mi_put_bytes() returns the address of the next buffer to which data can be copied. The function advances the returned address by nbytes bytes, ready for copying in the next value. In other words, if n is the length of the value that val_ptr identifies, the returned address is n bytes advanced from the original buffer address in data_ptr.

The mi_put_bytes() function is useful in a send support function of an opaque data type when aligned values need to be sent to possibly unaligned data buffers of a client application.

See the description of the following functions: mi_fix_integer(), mi_fix_smallint(), mi_get_bytes(), mi_put_date(), mi_put_datetime(), mi_put_decimal(), mi_put_double_precision(), mi_put_int8(), mi_put_integer(), mi_put_interval(), mi_put_lo_handle(), mi_put_money(), mi_put_real(), mi_put_smallint(), and mi_put_string().

For more information on the use of mi_put_bytes() in a send support function, see Converting Opaque-Type Data With Machine-Specific Data Types.