INFORMIX
DataBlade API Programmer's Manual
Chapter 12: DataBlade API Function Descriptions
Home Contents Index Master Index New Book

mi_get_smallint()

 The mi_get_smallint() function copies a smallint value from a buffer regardless of alignment.

Syntax

Usage

 For maximum portability, this function accepts a fully promoted mi_integer value instead of an mi_smallint value. This argument might therefore require casting.

The mi_get_smallint() function is useful for implementing send and receive functions for user data types when aligned values such as an mi_smallint need to be read from possibly unaligned data buffers.

The returned address is advanced by the size of an mi_smallint type to permit a subsequent copy.

The returned address is 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

A new datap address.

Upon completion, mi_get_smallint() returns the address of the next buffer from which data can be copied.

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_put_bytes(), mi_put_double_precision(), mi_put_integer(), and mi_put_smallint().



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