GATE based type encapsulation support. More...

#include "gate/gate_core_api.h"
#include "gate/gatetypes.h"
#include "gate/strings.h"
#include "gate/objects.h"
#include "gate/times.h"
#include "gate/guids.h"
#include "gate/arrays.h"
#include "gate/maps.h"
#include "gate/structs.h"
#include "gate/blobs.h"
#include "gate/typeids.h"
#include <stddef.h>

Classes
struct	gate_value_class
	Variable value carrier object. More...

Typedefs
typedef struct gate_value_class	gate_value_t
	Variable value carrier object.

Functions
GATE_CORE_API gate_value_t *	gate_value_create (gate_type_id_t value_type, void const src, gate_value_t dst)
	Initializes a value type with a copy of given source data type.

GATE_CORE_API gate_value_t *	gate_value_clone (gate_value_t const src, gate_value_t dst)
	Initializes a new value by copying/cloning the contents of another value object.

GATE_CORE_API void	gate_value_release (gate_value_t *dst)
	Releases all allocated data of the contained value type.

GATE_CORE_API gate_result_t	gate_value_get (gate_value_t const src, void ptrdst, gate_size_t dstlen)
	Creates a copy of a contained value in a destination storage area.

GATE_CORE_API void const *	gate_value_get_ptr (gate_value_t const *src)
	Returns a pointer to the content of a value object.

GATE_CORE_API gate_type_id_t	gate_value_type (gate_value_t const *src)
	Returns the value type ID of content in a value object.

GATE_CORE_API gate_result_t	gate_value_load_bool (gate_type_id_t src_type, void const src, gate_bool_t dst)

GATE_CORE_API gate_result_t	gate_value_load_int8 (gate_type_id_t src_type, void const src, gate_int8_t dst)

GATE_CORE_API gate_result_t	gate_value_load_int16 (gate_type_id_t src_type, void const src, gate_int16_t dst)

GATE_CORE_API gate_result_t	gate_value_load_int32 (gate_type_id_t src_type, void const src, gate_int32_t dst)

GATE_CORE_API gate_result_t	gate_value_load_int64 (gate_type_id_t src_type, void const src, gate_int64_t dst)

GATE_CORE_API gate_result_t	gate_value_load_uint8 (gate_type_id_t src_type, void const src, gate_uint8_t dst)

GATE_CORE_API gate_result_t	gate_value_load_uint16 (gate_type_id_t src_type, void const src, gate_uint16_t dst)

GATE_CORE_API gate_result_t	gate_value_load_uint32 (gate_type_id_t src_type, void const src, gate_uint32_t dst)

GATE_CORE_API gate_result_t	gate_value_load_uint64 (gate_type_id_t src_type, void const src, gate_uint64_t dst)

GATE_CORE_API gate_result_t	gate_value_load_real32 (gate_type_id_t src_type, void const src, gate_real32_t dst)

GATE_CORE_API gate_result_t	gate_value_load_real64 (gate_type_id_t src_type, void const src, gate_real64_t dst)

GATE_CORE_API gate_result_t	gate_value_load_string (gate_type_id_t src_type, void const src, gate_string_t dst)

GATE_CORE_API gate_result_t	gate_value_load_blob (gate_type_id_t src_type, void const src, gate_blob_t dst)

GATE_CORE_API gate_result_t	gate_value_save_bool (gate_bool_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_int8 (gate_int8_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_int16 (gate_int16_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_int32 (gate_int32_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_int64 (gate_int64_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_uint8 (gate_uint8_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_uint16 (gate_uint16_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_uint32 (gate_uint32_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_uint64 (gate_uint64_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_real32 (gate_real32_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_real64 (gate_real64_t src, gate_type_id_t dst_type, void *dst)

GATE_CORE_API gate_result_t	gate_value_save_string (gate_string_t const src, gate_type_id_t dst_type, void dst)

GATE_CORE_API gate_result_t	gate_value_save_blob (gate_blob_t const src, gate_type_id_t dst_type, void dst)

GATE_CORE_API gate_result_t	gate_value_copy_constructor (void dest, void const src)

GATE_CORE_API void	gate_value_destructor (void *dest)

GATE_CORE_API gate_size_t	gate_value_serialize (gate_value_t const src, char dest_buffer, gate_size_t dest_buffer_len)

GATE_CORE_API gate_result_t	gate_value_deserialize (char const src_buffer, gate_size_t src_buffer_len, gate_value_t dst)

Detailed Description

GATE based type encapsulation support.

Typedef Documentation

◆ gate_value_t

typedef struct gate_value_class gate_value_t

Variable value carrier object.

Stores each possible gate type and a related type ID. The different values are stored on a union, no heap allocation is required

Function Documentation

◆ gate_value_clone()

GATE_CORE_API gate_value_t * gate_value_clone	(	gate_value_t const *	src,
		gate_value_t *	dst )

Initializes a new value by copying/cloning the contents of another value object.

Primitive types are copied, reference types are duplicated and their reference counter is increased

Parameters

[in]	src	Pointer source value thats content is copied/cloned
[out]	dst	Initialized with value object containing a cloned content of `src`

Returns: dst in case of success, otherwise NULL

◆ gate_value_create()

GATE_CORE_API gate_value_t * gate_value_create	(	gate_type_id_t	value_type,
		void const *	src,
		gate_value_t *	dst )

Initializes a value type with a copy of given source data type.

Parameters

[in]	value_type	Type-ID specifying the data type of the value to be constructed
[in]	src	Pointer to native data type to be copied into new value specified by `value_type`
[out]	dst	Initialized with value object containing a copy of `src`

Returns: dst in case of success, otherwise NULL

◆ gate_value_get()

GATE_CORE_API gate_result_t gate_value_get	(	gate_value_t const *	src,
		void *	ptrdst,
		gate_size_t	dstlen )

Creates a copy of a contained value in a destination storage area.

Parameters

[in]	src	Value object thats content is accessed
[out]	ptrdst	Pointer to target storage that is initialized with a copy of the value content
[in]	dstlen	Capacity of storage in `ptrdst` in bytes

Returns: GATE_RESULT_* result code

◆ gate_value_get_ptr()

GATE_CORE_API void const * gate_value_get_ptr ( gate_value_t const * src )

Returns a pointer to the content of a value object.

Parameters

[in] src Pointer to value object thats content is accessed

Returns: Pointer to content in value object

◆ gate_value_release()

GATE_CORE_API void gate_value_release ( gate_value_t * dst )

Releases all allocated data of the contained value type.

Reference types' reference counter is decreased, heap allocated objects are freed by their destruction function

Parameters

[in] dst Pointer to value object to be released

◆ gate_value_type()

GATE_CORE_API gate_type_id_t gate_value_type ( gate_value_t const * src )

Returns the value type ID of content in a value object.

Parameters

[in] src Pointer to value object thats content is accessed

Returns: Value type ID of content

Classes

Typedefs

Functions

Detailed Description

Typedef Documentation

◆ gate_value_t

Function Documentation

◆ gate_value_clone()

◆ gate_value_create()

◆ gate_value_get()

◆ gate_value_get_ptr()

◆ gate_value_release()

◆ gate_value_type()