Get an element from an array field by field index


Functions

LBMSDMExpDLL int lbmsdm_msg_get_boolean_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, uint8_t *Value)
 Fetch an array field element value from a message by field index.
LBMSDMExpDLL int lbmsdm_msg_get_int8_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, int8_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_uint8_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, uint8_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_int16_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, int16_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_uint16_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, uint16_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_int32_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, int32_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_uint32_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, uint32_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_int64_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, int64_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_uint64_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, uint64_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_float_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, float *Value)
LBMSDMExpDLL int lbmsdm_msg_get_double_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, double *Value)
LBMSDMExpDLL int lbmsdm_msg_get_decimal_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, lbmsdm_decimal_t *Value)
LBMSDMExpDLL int lbmsdm_msg_get_timestamp_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, struct timeval *Value)
LBMSDMExpDLL int lbmsdm_msg_get_message_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, lbmsdm_msg_t **Value)
LBMSDMExpDLL int lbmsdm_msg_get_string_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, char *Value, size_t *Size)
 Fetch a string array field element value from a message by field index.
LBMSDMExpDLL int lbmsdm_msg_get_unicode_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, wchar_t *Value, size_t *Size)
 Fetch a unicode array field element value from a message by field index.
LBMSDMExpDLL int lbmsdm_msg_get_blob_elem_idx (lbmsdm_msg_t *Message, size_t Index, size_t Element, void *Value, size_t *Size)
 Fetch a BLOB array field element value from a message by field index.

Detailed Description

The functions in this group allow the retrieval of an element value of an array field, referenced by field index.

Function Documentation

LBMSDMExpDLL int lbmsdm_msg_get_blob_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
void *  Value,
size_t *  Size 
)

Parameters:
Message The SDM message from which the field is to be fetched.
Index Field index.
Element Element number (zero-based).
Value Pointer to variable where the value is stored.
Size Pointer to a variable containing the maximum size of Value in bytes.. On exit, it will contain the actual size of the data.
Return values:
LBMSDM_SUCCESS if successful
LBMSDM_INSUFFICIENT_BUFFER_LENGTH if Size is not large enough for the data. Size will contain the length required in bytes.
LBMSDM_FAILURE otherwise.

LBMSDMExpDLL int lbmsdm_msg_get_boolean_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
uint8_t *  Value 
)

Parameters:
Message The SDM message from which the field is to be fetched.
Index Field index.
Element Element number (zero-based).
Value Pointer to variable where the value is stored.
Returns:
LBMSDM_SUCCESS if successful, LBMSDM_FAILURE otherwise.

LBMSDMExpDLL int lbmsdm_msg_get_decimal_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
lbmsdm_decimal_t Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_double_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
double *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_float_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
float *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_int16_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
int16_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_int32_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
int32_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_int64_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
int64_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_int8_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
int8_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_message_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
lbmsdm_msg_t **  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_string_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
char *  Value,
size_t *  Size 
)

Parameters:
Message The SDM message from which the field is to be fetched.
Index Field index.
Element Element number (zero-based).
Value Pointer to variable where the value is stored.
Size Pointer to a variable containing the maximum size of Value (including the terminating null character). On exit, it will contain the actual size of the string (including the terminating null character).
Return values:
LBMSDM_SUCCESS if successful
LBMSDM_INSUFFICIENT_BUFFER_LENGTH if Size is not large enough for the string. Size will contain the length required.
LBMSDM_FAILURE otherwise.

LBMSDMExpDLL int lbmsdm_msg_get_timestamp_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
struct timeval *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_uint16_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
uint16_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_uint32_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
uint32_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_uint64_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
uint64_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_uint8_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
uint8_t *  Value 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

LBMSDMExpDLL int lbmsdm_msg_get_unicode_elem_idx ( lbmsdm_msg_t Message,
size_t  Index,
size_t  Element,
wchar_t *  Value,
size_t *  Size 
)

Parameters:
Message The SDM message from which the field is to be fetched.
Index Field index.
Element Element number (zero-based).
Value Pointer to variable where the value is stored.
Size Pointer to a variable containing the maximum size of Value in wchar_ts. On exit, it will contain the actual size of the data in wchar_ts.
Return values:
LBMSDM_SUCCESS if successful
LBMSDM_INSUFFICIENT_BUFFER_LENGTH if Size is not large enough for the data. Size will contain the length required in wchar_ts.
LBMSDM_FAILURE otherwise.


Generated on Thu Mar 6 13:11:16 2014 for LBM API by  doxygen 1.5.2