Compares generic value storage.

Parameters:

[in]	a	left side of comparison
[in]	b	right side of comparison

Returns:

less than zero if a < b, greater than zero if a > b, zero if a == b

Since (EFL) :

1.2

Converts one value to another type.

Parameters:

[in]	value	Source value object.
[out]	convert	Destination value object.

Returns:

EINA_TRUE if converted, EINA_FALSE otherwise.

Converts one value to another trying first value type convert_to() function. If unsuccessful, tries using convert_from() function in convert.

Conversion functions are type defined, and the basic types can convert between themselves, but conversion is strict! That is, if converting from negative value to unsigned type, it will fail. It also fails on value overflow.

It is recommended that all types implement at least convert to string, used by eina_value_to_string().

Note:

Both objects must have eina_value_setup() called on them beforehand!

Since (EFL) :

1.2

Since :

3.0

Examples:

eina_value_01.c.

Copies generic value storage.

Parameters:

[in]	value	Source value object
[out]	copy	Destination value object

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

The copy object is considered uninitialized and its existing contents are overwritten (just as if eina_value_flush() was called on it).

The copy happens by calling eina_value_setup() on copy, followed by getting the contents of value and setting it to copy.

Since (EFL) :

1.2

Since :

3.0

Empties a generic value storage.

Parameters:

[in]

value

Value object

Releases all the resources associated with an Eina_Value. The value must be already set with eina_value_setup() or eina_value_new().

After this call returns, the contents of the value are undefined, but the value can be reused by calling eina_value_setup() again.

See also:

eina_value_setup()

eina_value_free()

Since (EFL) :

1.2

Examples:

eina_value_01.c.

Frees value and its data.

Parameters:

[in]

value

value object

See also:

eina_value_flush()

Since (EFL) :

1.2

Since :

3.0

Examples:

eina_value_02.c, and eina_value_03.c.

Gets the generic value.

Parameters:

[in]	value	Source value object.
[out]	...	Data value retrieved.

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

The value is returned in the variable argument parameter, the actual value is type-dependent, but usually it will be what is stored inside the object. There shouldn't be any memory allocation, thus the contents should not be freed.

The variable argument is dependent on chosen type. The list for basic types:

• EINA_VALUE_TYPE_VALUE: Eina_Value*
• EINA_VALUE_TYPE_ERROR: Eina_Error*
• EINA_VALUE_TYPE_UCHAR: unsigned char*
• EINA_VALUE_TYPE_USHORT: unsigned short*
• EINA_VALUE_TYPE_UINT: unsigned int*
• EINA_VALUE_TYPE_ULONG: unsigned long*
• EINA_VALUE_TYPE_UINT64: uint64_t*
• EINA_VALUE_TYPE_CHAR: char*
• EINA_VALUE_TYPE_SHORT: short*
• EINA_VALUE_TYPE_INT: int*
• EINA_VALUE_TYPE_LONG: long*
• EINA_VALUE_TYPE_INT64: int64_t*
• EINA_VALUE_TYPE_FLOAT: float*
• EINA_VALUE_TYPE_DOUBLE: double*
• EINA_VALUE_TYPE_STRINGSHARE: const char **
• EINA_VALUE_TYPE_STRING: const char **
• EINA_VALUE_TYPE_ARRAY: Eina_Value_Array*
• EINA_VALUE_TYPE_LIST: Eina_Value_List*
• EINA_VALUE_TYPE_HASH: Eina_Value_Hash*
• EINA_VALUE_TYPE_TIMEVAL: struct timeval*
• EINA_VALUE_TYPE_BLOB: Eina_Value_Blob*
• EINA_VALUE_TYPE_STRUCT: Eina_Value_Struct*
• EINA_VALUE_TYPE_TM: struct tm*

     Eina_Value *value = eina_value_new(EINA_VALUE_TYPE_INT);
     int x;
     const char *s;

     eina_value_set(value, 1234);
     eina_value_get(value, &x);

     eina_value_flush(value);

     eina_value_setup(value, EINA_VALUE_TYPE_STRING);
     eina_value_set(value, "hello world!");
     eina_value_get(value, &s);

     eina_value_free(value);

Note:

for array member see eina_value_array_get()

for list member see eina_value_list_get()

for hash member see eina_value_hash_get()

See also:

eina_value_set()

eina_value_vset()

eina_value_pset()

Since (EFL) :

1.2

Examples:

eina_value_01.c, and prefs_example_03.c.

Creates generic value storage.

Parameters:

[in]

type

How to manage this value.

Returns:

The new value or NULL on failure.

Create a new generic value storage. The members are managed using the description specified by type.

Some types may specify more operations: e.g.. EINA_VALUE_TYPE_ARRAY uses eina_value_array_set(), eina_value_array_get() and so on.

On failure, NULL is returned.

Note:

This calls creates from mempool and then uses eina_value_setup(). Consider using eina_value_flush() and eina_value_setup() instead to avoid memory allocations.

See also:

eina_value_free()

Since (EFL) :

1.2

Since :

3.0

Gets the generic value to pointer.

Parameters:

[in]	value	Source value object
[out]	ptr	Pointer to receive the contents.

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

The value is returned in pointer contents, the actual value is type-dependent, but usually it will be what is stored inside the object. There shouldn't be any memory allocation, thus the contents should not be freed.

The pointer type is dependent on chosen value type. The list for basic types:

• EINA_VALUE_TYPE_VALUE: Eina_Value*
• EINA_VALUE_TYPE_ERROR: Eina_Error*
• EINA_VALUE_TYPE_UCHAR: unsigned char*
• EINA_VALUE_TYPE_USHORT: unsigned short*
• EINA_VALUE_TYPE_UINT: unsigned int*
• EINA_VALUE_TYPE_ULONG: unsigned long*
• EINA_VALUE_TYPE_UINT64: uint64_t*
• EINA_VALUE_TYPE_CHAR: char*
• EINA_VALUE_TYPE_SHORT: short*
• EINA_VALUE_TYPE_INT: int*
• EINA_VALUE_TYPE_LONG: long*
• EINA_VALUE_TYPE_INT64: int64_t*
• EINA_VALUE_TYPE_FLOAT: float*
• EINA_VALUE_TYPE_DOUBLE: double*
• EINA_VALUE_TYPE_STRINGSHARE: const char **
• EINA_VALUE_TYPE_STRING: const char **
• EINA_VALUE_TYPE_ARRAY: Eina_Value_Array*
• EINA_VALUE_TYPE_LIST: Eina_Value_List*
• EINA_VALUE_TYPE_HASH: Eina_Value_Hash*
• EINA_VALUE_TYPE_TIMEVAL: struct timeval*
• EINA_VALUE_TYPE_BLOB: Eina_Value_Blob*
• EINA_VALUE_TYPE_STRUCT: Eina_Value_Struct
• EINA_VALUE_TYPE_TM: struct tm*

     Eina_Value *value = eina_value_new(EINA_VALUE_TYPE_INT);
     int x;
     const char *s;

     eina_value_set(value, 1234);
     eina_value_pget(value, &x);

     eina_value_flush(value);

     eina_value_setup(value, EINA_VALUE_TYPE_STRING);
     eina_value_set(value, "hello world!");
     eina_value_pget(value, &s);

     eina_value_free(value);

Note:

for array member see eina_value_array_get()

for list member see eina_value_list_get()

for hash member see eina_value_hash_get()

See also:

eina_value_set()

eina_value_vset()

eina_value_pset()

Since (EFL) :

1.2

Sets the generic value from pointer.

Parameters:

[in,out]	value	Source value object
[in]	ptr	Pointer to specify the contents.

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

The pointer type is dependent on chosen value type. The list for basic types:

• EINA_VALUE_TYPE_VALUE: Eina_Value*
• EINA_VALUE_TYPE_ERROR: Eina_Error*
• EINA_VALUE_TYPE_UCHAR: unsigned char*
• EINA_VALUE_TYPE_USHORT: unsigned short*
• EINA_VALUE_TYPE_UINT: unsigned int*
• EINA_VALUE_TYPE_ULONG: unsigned long*
• EINA_VALUE_TYPE_UINT64: uint64_t*
• EINA_VALUE_TYPE_CHAR: char*
• EINA_VALUE_TYPE_SHORT: short*
• EINA_VALUE_TYPE_INT: int*
• EINA_VALUE_TYPE_LONG: long*
• EINA_VALUE_TYPE_INT64: int64_t*
• EINA_VALUE_TYPE_FLOAT: float*
• EINA_VALUE_TYPE_DOUBLE: double*
• EINA_VALUE_TYPE_STRINGSHARE: const char **
• EINA_VALUE_TYPE_STRING: const char **
• EINA_VALUE_TYPE_ARRAY: Eina_Value_Array*
• EINA_VALUE_TYPE_LIST: Eina_Value_List*
• EINA_VALUE_TYPE_HASH: Eina_Value_Hash*
• EINA_VALUE_TYPE_TIMEVAL: struct timeval*
• EINA_VALUE_TYPE_BLOB: Eina_Value_Blob*
• EINA_VALUE_TYPE_STRUCT: Eina_Value_Struct*
• EINA_VALUE_TYPE_TM: struct tm*

Note:

the pointer contents are written using the size defined by type. It can be larger than void* or uint64_t.

     Eina_Value *value = eina_value_new(EINA_VALUE_TYPE_INT);
     int x = 567;
     const char *s = "hello world!";

     eina_value_pset(value, &x);

     eina_value_flush(value);

     eina_value_setup(value, EINA_VALUE_TYPE_STRING);
     eina_value_pset(value, &s);

     eina_value_free(value);

Note:

for array member see eina_value_array_pset()

for list member see eina_value_list_pset()

for hash member see eina_value_hash_pset()

See also:

eina_value_pget()

eina_value_set()

eina_value_vset()

Since (EFL) :

1.2

Sets the generic value.

Parameters:

[in,out]	value	Source value object
[in]	...	Data to set.

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

The variable argument is dependent on chosen type. The list for basic types:

• EINA_VALUE_TYPE_VALUE: Eina_Value
• EINA_VALUE_TYPE_ERROR: Eina_Error
• EINA_VALUE_TYPE_UCHAR: unsigned char
• EINA_VALUE_TYPE_USHORT: unsigned short
• EINA_VALUE_TYPE_UINT: unsigned int
• EINA_VALUE_TYPE_ULONG: unsigned long
• EINA_VALUE_TYPE_UINT64: uint64_t
• EINA_VALUE_TYPE_CHAR: char
• EINA_VALUE_TYPE_SHORT: short
• EINA_VALUE_TYPE_INT: int
• EINA_VALUE_TYPE_LONG: long
• EINA_VALUE_TYPE_INT64: int64_t
• EINA_VALUE_TYPE_FLOAT: float
• EINA_VALUE_TYPE_DOUBLE: double
• EINA_VALUE_TYPE_STRINGSHARE: const char *
• EINA_VALUE_TYPE_STRING: const char *
• EINA_VALUE_TYPE_ARRAY: Eina_Value_Array
• EINA_VALUE_TYPE_LIST: Eina_Value_List
• EINA_VALUE_TYPE_HASH: Eina_Value_Hash
• EINA_VALUE_TYPE_TIMEVAL: struct timeval
• EINA_VALUE_TYPE_BLOB: Eina_Value_Blob
• EINA_VALUE_TYPE_STRUCT: Eina_Value_Struct
• EINA_VALUE_TYPE_TM: struct tm*

     Eina_Value *value = eina_value_new(EINA_VALUE_TYPE_INT);
     int x = 567;
     eina_value_set(value, 1234);
     eina_value_set(value, x);

     eina_value_flush(value);

     eina_value_setup(value, EINA_VALUE_TYPE_STRING);
     eina_value_set(value, "hello world!");

     eina_value_free(value);

Note:

for array member see eina_value_array_set()

for list member see eina_value_list_set()

for hash member see eina_value_hash_set()

See also:

eina_value_get()

eina_value_vset()

eina_value_pset()

Since (EFL) :

1.2

Examples:

eina_value_01.c, eina_value_03.c, prefs_data_example.c, prefs_example_01.c, and prefs_example_02.c.

Initializes generic value storage.

Parameters:

[out]	value	Value object
[out]	type	How to manage this value.

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

Initializes existing generic value storage. The members are managed using the description specified by type.

Some types may specify more operations, as an example EINA_VALUE_TYPE_ARRAY uses eina_value_array_set(), eina_value_array_get() and so on.

Note:

Existing contents are ignored! If the value was previously used, then use eina_value_flush() first.

On failure, EINA_FALSE is returned.

See also:

eina_value_flush()

Since (EFL) :

1.2

Examples:

eina_value_01.c, eina_value_03.c, and prefs_data_example.c.

Converts value to string.

Parameters:

[in]

value

value object.

Returns:

newly allocated memory or NULL on failure.

See also:

eina_value_convert()

eina_value_to_binbuf()

Since (EFL) :

1.2

Since :

3.0

Examples:

eina_value_01.c, eina_value_03.c, and prefs_data_example.c.

Queries value type.

Parameters:

[in]

value

Value object.

Returns:

Type instance, or NULL if type is invalid.

Check if value type is valid and returns it. A type is invalid if it does not exist or if it is using a different version field.

See also:

eina_value_type_check()

Since (EFL) :

1.2

Gets the generic value.

Parameters:

[in]	value	Source value object
[out]	args	Variable argument

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

The value is returned in the variable argument parameter, the actual value is type-dependent, but usually it will be what is stored inside the object. There shouldn't be any memory allocation, thus the contents should not be freed.

Note:

for array member see eina_value_array_vget()

for list member see eina_value_list_vget()

for hash member see eina_value_hash_vget()

See also:

eina_value_vset()

eina_value_get()

eina_value_pget()

Since (EFL) :

1.2

Sets the generic value.

Parameters:

[in,out]	value	Source value object
[in]	args	Variable argument

Returns:

EINA_TRUE on success, EINA_FALSE otherwise.

Note:

for array member see eina_value_array_vset()

for list member see eina_value_list_vset()

for hash member see eina_value_hash_vset()

See also:

eina_value_vget()

eina_value_set()

eina_value_pset()

Since (EFL) :

1.2