Get scalar field values by field name

Functions
LBMSDMExpDLL int	lbmsdm_msg_get_boolean_name (lbmsdm_msg_t *Message, const char *Name, uint8_t *Value)
	Fetch a field value from a message by field name.
LBMSDMExpDLL int	lbmsdm_msg_get_int8_name (lbmsdm_msg_t *Message, const char *Name, int8_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_uint8_name (lbmsdm_msg_t *Message, const char *Name, uint8_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_int16_name (lbmsdm_msg_t *Message, const char *Name, int16_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_uint16_name (lbmsdm_msg_t *Message, const char *Name, uint16_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_int32_name (lbmsdm_msg_t *Message, const char *Name, int32_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_uint32_name (lbmsdm_msg_t *Message, const char *Name, uint32_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_int64_name (lbmsdm_msg_t *Message, const char *Name, int64_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_uint64_name (lbmsdm_msg_t *Message, const char *Name, uint64_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_float_name (lbmsdm_msg_t *Message, const char *Name, float *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_double_name (lbmsdm_msg_t *Message, const char *Name, double *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_decimal_name (lbmsdm_msg_t *Message, const char *Name, lbmsdm_decimal_t *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_timestamp_name (lbmsdm_msg_t *Message, const char *Name, struct timeval *Value)
LBMSDMExpDLL int	lbmsdm_msg_get_message_name (lbmsdm_msg_t *Message, const char *Name, lbmsdm_msg_t **Value)
LBMSDMExpDLL int	lbmsdm_msg_get_string_name (lbmsdm_msg_t *Message, const char *Name, char *Value, size_t *Size)
	Fetch a string field value from a message by field name.
LBMSDMExpDLL int	lbmsdm_msg_get_unicode_name (lbmsdm_msg_t *Message, const char *Name, wchar_t *Value, size_t *Size)
	Fetch a unicode field value from a message by field name.
LBMSDMExpDLL int	lbmsdm_msg_get_blob_name (lbmsdm_msg_t *Message, const char *Name, void *Value, size_t *Size)
	Fetch a BLOB field value from a message by field name.

---

Detailed Description

The functions in this group allow the retrieval of the value of a scalar (non-array) field, referenced by field name.

---

Function Documentation

LBMSDMExpDLL int lbmsdm_msg_get_blob_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		void *	Value,
		size_t *	Size
	)

Parameters:

	Message	The SDM message from which the field is to be fetched.
	Name	Field name.
	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 string. Size will contain the length required in bytes.
	LBMSDM_FAILURE	otherwise.

LBMSDMExpDLL int lbmsdm_msg_get_boolean_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		uint8_t *	Value
	)

Parameters:

	Message	The SDM message from which the field is to be fetched.
	Name	Field name.
	Value	Pointer to variable where the value is stored.

Returns:

LBMSDM_SUCCESS if successful, LBMSDM_FAILURE otherwise.

LBMSDMExpDLL int lbmsdm_msg_get_decimal_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		char *	Value,
		size_t *	Size
	)

Parameters:

	Message	The SDM message from which the field is to be fetched.
	Name	Field name.
	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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		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_name	(	lbmsdm_msg_t *	Message,
		const char *	Name,
		wchar_t *	Value,
		size_t *	Size
	)

Parameters:

	Message	The SDM message from which the field is to be fetched.
	Name	Field name.
	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 string. Size will contain the length required in wchar_ts.
	LBMSDM_FAILURE	otherwise.

---