Topics

 Generic Value management
 
 
 Generic Value Array management
 
 
 Generic Value List management
 
 
 Generic Value Hash management
 
 
 Generic Value Blob management
 
 
 Generic Value Struct management
 
 
 Generic Value Type management
 
 

Data Structures

union  _Eina_Value_Union
 All possible value types. More...
 

Typedefs

typedef struct _Eina_Value Eina_Value
 Store generic values.
 
typedef struct _Eina_Value_Type Eina_Value_Type
 Describes the data contained by the value.
 
typedef union _Eina_Value_Union Eina_Value_Union
 Union of all known value types.
 

Variables

const Eina_Value_TypeEINA_VALUE_TYPE_UCHAR
 manages unsigned char type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_USHORT
 manages unsigned short type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_UINT
 manages unsigned int type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_ULONG
 manages unsigned long type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_TIMESTAMP
 manages unsigned long type used for timestamps.
 
const Eina_Value_TypeEINA_VALUE_TYPE_UINT64
 manages unsigned integer of 64 bits type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_CHAR
 manages char type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_SHORT
 manages short type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_INT
 manages int type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_LONG
 manages long type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_INT64
 manages integer of 64 bits type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_FLOAT
 manages float type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_DOUBLE
 manages double type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_STRINGSHARE
 manages stringshared string type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_STRING
 manages string type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_ARRAY
 manages array type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_LIST
 manages list type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_HASH
 manages hash type.
 
const Eina_Value_TypeEINA_VALUE_TYPE_TIMEVAL
 manages 'struct timeval' type
 
const Eina_Value_TypeEINA_VALUE_TYPE_BLOB
 manages blob of bytes type, see Eina_Value_Blob
 
const Eina_Value_TypeEINA_VALUE_TYPE_STRUCT
 manages struct type.
 
int EINA_ERROR_VALUE_FAILED
 Error identifier corresponding to value check failure.
 

Detailed Description

Abstracts generic data storage and access to it in an extensible and efficient way.

It comes with pre-defined types for numbers, array, list, hash, blob and structs. It is able to convert between data types, including to string.

It is meant for simple data types, providing uniform access and release functions, useful to exchange data preserving their types. For more complex hierarchical data, with properties and children, reference counting, inheritance and interfaces,

Examples of usage of the Eina_Value API:

Typedef Documentation

◆ Eina_Value

typedef struct _Eina_Value Eina_Value

Store generic values.

Since
1.2

◆ Eina_Value_Type

Describes the data contained by the value.

Since
1.2

◆ Eina_Value_Union

Union of all known value types.

This is only used to specify the minimum payload memory for Eina_Value.

Variable Documentation

◆ EINA_VALUE_TYPE_UCHAR

const Eina_Value_Type* EINA_VALUE_TYPE_UCHAR
extern

manages unsigned char type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_USHORT

const Eina_Value_Type* EINA_VALUE_TYPE_USHORT
extern

manages unsigned short type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_UINT

const Eina_Value_Type* EINA_VALUE_TYPE_UINT
extern

manages unsigned int type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_ULONG

const Eina_Value_Type* EINA_VALUE_TYPE_ULONG
extern

manages unsigned long type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_TIMESTAMP

const Eina_Value_Type* EINA_VALUE_TYPE_TIMESTAMP
extern

manages unsigned long type used for timestamps.

Note
this is identical in function to EINA_VALUE_TYPE_ULONG
Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_UINT64

const Eina_Value_Type* EINA_VALUE_TYPE_UINT64
extern

manages unsigned integer of 64 bits type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_CHAR

const Eina_Value_Type* EINA_VALUE_TYPE_CHAR
extern

manages char type.

Since
1.2
Examples
eina_value_02.c, and eina_value_03.c.

◆ EINA_VALUE_TYPE_SHORT

const Eina_Value_Type* EINA_VALUE_TYPE_SHORT
extern

manages short type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_INT

const Eina_Value_Type* EINA_VALUE_TYPE_INT
extern

manages int type.

Since
1.2
Examples
eina_value_01.c, eina_value_02.c, and eina_value_03.c.

◆ EINA_VALUE_TYPE_LONG

const Eina_Value_Type* EINA_VALUE_TYPE_LONG
extern

manages long type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_INT64

const Eina_Value_Type* EINA_VALUE_TYPE_INT64
extern

manages integer of 64 bits type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_FLOAT

const Eina_Value_Type* EINA_VALUE_TYPE_FLOAT
extern

manages float type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_DOUBLE

const Eina_Value_Type* EINA_VALUE_TYPE_DOUBLE
extern

manages double type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_STRINGSHARE

const Eina_Value_Type* EINA_VALUE_TYPE_STRINGSHARE
extern

manages stringshared string type.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_STRING

const Eina_Value_Type* EINA_VALUE_TYPE_STRING
extern

manages string type.

Since
1.2
Examples
eina_value_01.c, and eina_value_03.c.

Referenced by eina_value_to_string().

◆ EINA_VALUE_TYPE_ARRAY

const Eina_Value_Type* EINA_VALUE_TYPE_ARRAY
extern

manages array type.

Use the value get/set for arrays:

eina_value_set() takes an Eina_Value_Array where just subtype and step are used. If there is an array, it will be copied (including each item) and its contents must be properly configurable as subtype expects. eina_value_pset() takes a pointer to an Eina_Value_Array. For your convenience, use eina_value_array_setup().

eina_value_get() and eina_value_pget() takes a pointer to Eina_Value_Array, it's an exact copy of the current structure in use by value, no copies are done.

Since
1.2

◆ EINA_VALUE_TYPE_LIST

const Eina_Value_Type* EINA_VALUE_TYPE_LIST
extern

manages list type.

Use the value get/set for lists:

eina_value_set() takes an Eina_Value_List where just subtype is used. If there is an list, it will be copied (including each item) and its contents must be properly configurable as subtype expects. eina_value_pset() takes a pointer to an Eina_Value_List. For your convenience, use eina_value_list_setup().

eina_value_get() and eina_value_pget() takes a pointer to Eina_Value_List, it's an exact copy of the current structure in use by value, no copies are done.

Since
1.2

◆ EINA_VALUE_TYPE_HASH

const Eina_Value_Type* EINA_VALUE_TYPE_HASH
extern

manages hash type.

Use the value get/set for hashes:

eina_value_set() takes an Eina_Value_Hash where just subtype and buckets_power_size are used. If there is an hash, it will be copied (including each item) and its contents must be properly configurable as subtype expects. eina_value_pset() takes a pointer to an Eina_Value_Hash. For your convenience, use eina_value_hash_setup().

eina_value_get() and eina_value_pget() takes a pointer to Eina_Value_Hash, it's an exact copy of the current structure in use by value, no copies are done.

Note
be aware that hash data is always an allocated memory of size defined by subtype->value_size. If your subtype is an integer, add as data malloc(sizeof(int)). If your subtype is an string, add as data malloc(sizeof(char*)) and this data value must point to strdup(string)!
Since
1.2

◆ EINA_VALUE_TYPE_TIMEVAL

const Eina_Value_Type* EINA_VALUE_TYPE_TIMEVAL
extern

manages 'struct timeval' type

eina_value_set() takes a "struct timeval" from sys/time.h. eina_value_pset() takes a pointer to "struct timeval".

eina_value_get() and eina_value_pget() takes a pointer to "struct timeval" and it's an exact copy of value.

Since
1.2
Examples
eina_value_03.c.

◆ EINA_VALUE_TYPE_BLOB

const Eina_Value_Type* EINA_VALUE_TYPE_BLOB
extern

manages blob of bytes type, see Eina_Value_Blob

eina_value_set() takes an Eina_Value_Blob eina_value_pset() takes a pointer to Eina_Value_Blob.

eina_value_get() and eina_value_pget() takes a pointer to Eina_Value_Blob and it's an exact copy of value, no allocations are made.

Memory is untouched unless you provide ops (operations) pointer.

Since
1.2

◆ EINA_VALUE_TYPE_STRUCT

const Eina_Value_Type* EINA_VALUE_TYPE_STRUCT
extern

manages struct type.

Use the value get/set for structs:

eina_value_set() takes an Eina_Value_Struct where just desc is used. If there is an memory, it will be copied (including each member) and its contents must be properly configurable as desc expects. eina_value_pset() takes a pointer to an Eina_Value_Struct. For your convenience, use eina_value_struct_setup().

eina_value_get() and eina_value_pget() takes a pointer to Eina_Value_Struct, it's an exact copy of the current structure in use by value, no copies are done.

Since
1.2
Examples
eina_value_02.c.

◆ EINA_ERROR_VALUE_FAILED

int EINA_ERROR_VALUE_FAILED
extern

Error identifier corresponding to value check failure.

Since
1.2
Examples
eina_value_03.c.