DataBlade API Programmer's Manual

DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions

Home Contents Index Master Index New Book

mi_put_int8

The mi_put_int8() function copies an mi_int8 value to a buffer regardless of alignment.

Syntax

mi_unsigned_char1 *mi_put_int8(datap, valp)

		mi_unsigned_char1 *datap;

		mi_int8 *valp; 


datap
is a pointer to the buffer to which to copy the int8 value.

valp
is a pointer to the buffer from which to copy the int8 value.







 



Valid in Client Application?

Valid in Server Routine?

No
Yes

Usage

The mi_put_int8() function is useful for implementing send and receive functions for user-defined data types when aligned values such as an mi_int8 need to be written to possibly unaligned data buffers.

The returned address is advanced the length of an mi_int8 value to permit a subsequent copy. Upon completion, mi_put_int8() returns the address of the next buffer to which data can be copied, advanced the length of the copied value. In other words, if n is the length of the value in valp, the returned address is n bytes advanced from the original buffer address in datap.

Return Values

Returns a new datap address.

Related Topics

For additional information, see the descriptions of the following functions: mi_fix_integer(), mi_fix_smallint(), mi_get_bytes(), mi_get_double_precision(), mi_get_integer(), mi_get_smallint(), mi_put_bytes(), mi_put_double_precision(), mi_put_integer(), mi_put_smallint().

DataBlade API Programmer's Manual, version 9.1
Copyright © 1998, Informix Software, Inc. All rights reserved.