Eina tools aims to help application development, providing ways to make it safer, log errors, manage memory more efficiently and more.

For more information refer to the string example.

Functions
const char *	eina_environment_home_get (void)
	Returns the content of the environment referred by HOME on this system.
const char *	eina_environment_tmp_get (void)
	Returns the content of the environment referred as TMPDIR on this system.
static Eina_Bool	eina_dbl_exact (double a, double b)
	Warningless comparison of doubles using ==.
static Eina_Bool	eina_flt_exact (float a, float b)
	Warningless comparison of floats using ==.
Eina_Iterator *	eina_xattr_ls (const char *file)
	Gets an iterator that lists all extended attribute of a file.
Eina_Iterator *	eina_xattr_value_ls (const char *file)
	Gets an iterator that list all extended attribute value related to a fd.
Eina_Iterator *	eina_xattr_fd_ls (int fd)
	Gets an iterator that list all extended attribute related to a fd.
Eina_Iterator *	eina_xattr_value_fd_ls (int fd)
	Gets an iterator that list all extended attribute value related to a fd.
Eina_Bool	eina_xattr_copy (const char src, const char dst) 2)
	Copies the extended attribute from one file to another.
Eina_Bool	eina_xattr_fd_copy (int src, int dst)
	Copies the extended attribute from one file descriptor to another.
void *	eina_xattr_get (const char file, const char attribute, ssize_t *size) 2
	Retrieves an extended attribute from a file.
void void *	eina_xattr_fd_get (int fd, const char attribute, ssize_t size) 3)
	Retrieves an extended attribute from a file descriptor.
Eina_Bool	eina_xattr_set (const char file, const char attribute, const void *data, ssize_t length, Eina_Xattr_Flags flags) 2
	Sets an extended attribute on a file.
Eina_Bool Eina_Bool	eina_xattr_fd_set (int fd, const char attribute, const void data, ssize_t length, Eina_Xattr_Flags flags) 3)
	Sets an extended attribute on a file descriptor.
Eina_Bool	eina_xattr_del (const char file, const char attribute) 2)
	Deletes (removes) an extended attribute from a file.
Eina_Bool	eina_xattr_fd_del (int fd, const char *attribute)
	Deletes (removes) an extended attribute from a file descriptor.
Eina_Bool	eina_xattr_string_set (const char file, const char attribute, const char *data, Eina_Xattr_Flags flags)
	Sets a string as a extended attribute properties.
char *	eina_xattr_string_get (const char file, const char attribute)
	Gets a string from an extended attribute properties.
Eina_Bool	eina_xattr_double_set (const char file, const char attribute, double value, Eina_Xattr_Flags flags)
	Sets a double as a extended attribute properties.
Eina_Bool	eina_xattr_double_get (const char file, const char attribute, double *value)
	Gets a double from an extended attribute properties.
Eina_Bool	eina_xattr_int_set (const char file, const char attribute, int value, Eina_Xattr_Flags flags)
	Sets an int as a extended attribute properties.
Eina_Bool	eina_xattr_int_get (const char file, const char attribute, int *value)
	Gets a int from an extended attribute properties.
Defines
#define	EINA_FLT_EQ(a, b) (!!(fabsf((float)(a) - (float)(b)) <= FLT_EPSILON))
	Safe comparison of float.
#define	EINA_FLT_NONZERO(a) (!!(fpclassify((float)(a)) != FP_ZERO))
	Determines if a float is not zero.
#define	EINA_DBL_EQ(a, b) (!!(fabs((double)(a) - (double)(b)) <= DBL_EPSILON))
	Safe comparison of double.
#define	EINA_DBL_NONZERO(a) (!!(fpclassify((double)(a)) != FP_ZERO))
	Determines if a double is not zero.

Define Documentation

#define EINA_DBL_EQ	(	a,
		b
	)	(!!(fabs((double)(a) - (double)(b)) <= DBL_EPSILON))

Safe comparison of double.

Parameters:

[in]	a	First member to compare
[in]	b	Second member to compare

Since (EFL) :: 1.19

Returns:: true if two double match

#define EINA_DBL_NONZERO ( a ) (!!(fpclassify((double)(a)) != FP_ZERO))

Determines if a double is not zero.

Parameters:

[in] a The double

Returns:: true if double is not zero

Since (EFL) :: 1.19

#define EINA_FLT_EQ	(	a,
		b
	)	(!!(fabsf((float)(a) - (float)(b)) <= FLT_EPSILON))

Safe comparison of float.

Parameters:

[in]	a	First member to compare
[in]	b	Second member to compare

Since (EFL) :: 1.19

Returns:: true if two floats match

#define EINA_FLT_NONZERO ( a ) (!!(fpclassify((float)(a)) != FP_ZERO))

Determines if a float is not zero.

Parameters:

[in] a The float

Returns:: true if float is not zero

Since (EFL) :: 1.19

Enumeration Type Documentation

enum Eina_Xattr_Flags

define extended attribute creation

Since (EFL) :: 1.1

Enumerator:

EINA_XATTR_INSERT	This is the default behavior, it will either create or replace the extended attribute
EINA_XATTR_REPLACE	This will only succeed if the extended attribute previously existed
EINA_XATTR_CREATED	This will only succeed if the extended attribute wasn't previously set

Function Documentation

static Eina_Bool eina_dbl_exact	(	double	a,
		double	b
	)		`[static]`

Warningless comparison of doubles using ==.

Parameters:

[in]	a	First member to compare
[in]	b	Second member to compare

Returns:: true if two doubles match

Since (EFL) :: 1.19

const char* eina_environment_home_get ( void )

Returns the content of the environment referred by HOME on this system.

Returns:: A temporary string to the content referred by HOME on this system.

Note:: The result of this call is highly system dependent and you better use it instead of the naive getenv("HOME").

Since (EFL) :: 1.15

Since :: 3.0f(2.3.1)

const char* eina_environment_tmp_get ( void )

Returns the content of the environment referred as TMPDIR on this system.

Returns:: A temporary string to the content referred by TMPDIR on this system.

Note:: The result of this call is highly system dependent and you better use it instead of the naive getenv("TMPDIR").

Since (EFL) :: 1.15

Since :: 3.0f(2.3.1)

static Eina_Bool eina_flt_exact	(	float	a,
		float	b
	)		`[static]`

Warningless comparison of floats using ==.

Parameters:

[in]	a	First member to compare
[in]	b	Second member to compare

Returns:: true if two floats match

Since (EFL) :: 1.19

Eina_Bool eina_xattr_copy	(	const char *	src,
		const char *	dst
	)

Copies the extended attribute from one file to another.

Parameters:

[in]	src	source file to use as input.
[in]	dst	destination file to use as output.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

See also:: eina_xattr_fd_copy()

Since (EFL) :: 1.8

Since :: 3.0f(2.3.1)

Eina_Bool eina_xattr_del	(	const char *	file,
		const char *	attribute
	)

Deletes (removes) an extended attribute from a file.

Parameters:

[in]	file	The file to del the extended attribute from.
[in]	attribute	The attribute to del.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :: 1.8

Since :: 3.0f(2.3.1)

Eina_Bool eina_xattr_double_get	(	const char *	file,
		const char *	attribute,
		double *	value
	)

Gets a double from an extended attribute properties.

Parameters:

[in]	file	The file to get the string from.
[in]	attribute	The attribute to get.
[out]	value	Where to put the extracted value

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

This call check that the double is correctly set.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Bool eina_xattr_double_set	(	const char *	file,
		const char *	attribute,
		double	value,
		Eina_Xattr_Flags	flags
	)

Sets a double as a extended attribute properties.

Parameters:

[in]	file	The file to set the double to.
[in]	attribute	The attribute to set.
[in]	value	The NULL-terminated double to set.
[in]	flags	Define the set policy.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Bool eina_xattr_fd_copy	(	int	src,
		int	dst
	)

Copies the extended attribute from one file descriptor to another.

Parameters:

[in]	src	source file descriptor to use as input.
[in]	dst	destination file descriptor to use as output.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

See also:: eina_xattr_copy()

Since (EFL) :: 1.8

Since :: 3.0f(2.3.1)

Eina_Bool eina_xattr_fd_del	(	int	fd,
		const char *	attribute
	)

Deletes (removes) an extended attribute from a file descriptor.

Parameters:

[in]	fd	The file descriptor to del the extended attribute from.
[in]	attribute	The attribute to del.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :: 1.8

Since :: 3.0f(2.3.1)

void void* eina_xattr_fd_get	(	int	fd,
		const char *	attribute,
		ssize_t *	size
	)

Retrieves an extended attribute from a file descriptor.

Parameters:

[in]	fd	The file descriptor to retrieve the extended attribute from.
[in]	attribute	The extended attribute name to retrieve.
[out]	size	The size of the retrieved extended attribute.

Returns:: the allocated data that hold the extended attribute value.

It will return NULL and *size will be 0 if it fails.

Since (EFL) :: 1.8

Since :: 3.0f(2.3.1)

Eina_Iterator* eina_xattr_fd_ls ( int fd )

Gets an iterator that list all extended attribute related to a fd.

Parameters:

[in] fd The file descriptor to retrieve the extended attribute list from.

Returns:: an iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need.

Since (EFL) :: 1.2

Since :: 2.3

Eina_Bool Eina_Bool eina_xattr_fd_set	(	int	fd,
		const char *	attribute,
		const void *	data,
		ssize_t	length,
		Eina_Xattr_Flags	flags
	)

Sets an extended attribute on a file descriptor.

Parameters:

[in]	fd	The file descriptor to set the extended attribute to.
[in]	attribute	The attribute to set.
[in]	data	The data to set.
[in]	length	The length of the data to set.
[in]	flags	Define the set policy.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :: 1.8

Since :: 3.0f(2.3.1)

void* eina_xattr_get	(	const char *	file,
		const char *	attribute,
		ssize_t *	size
	)

Retrieves an extended attribute from a file.

Parameters:

[in]	file	The file to retrieve the extended attribute from.
[in]	attribute	The extended attribute name to retrieve.
[out]	size	The size of the retrieved extended attribute.

Returns:: the allocated data that hold the extended attribute value.

It will return NULL and *size will be 0 if it fails.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Bool eina_xattr_int_get	(	const char *	file,
		const char *	attribute,
		int *	value
	)

Gets a int from an extended attribute properties.

Parameters:

[in]	file	The file to get the string from.
[in]	attribute	The attribute to get.
[out]	value	Where to put the extracted value

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

This call check that the int is correctly set.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Bool eina_xattr_int_set	(	const char *	file,
		const char *	attribute,
		int	value,
		Eina_Xattr_Flags	flags
	)

Sets an int as a extended attribute properties.

Parameters:

[in]	file	The file to set the int to.
[in]	attribute	The attribute to set.
[in]	value	The NULL-terminated int to set.
[in]	flags	Define the set policy.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Iterator* eina_xattr_ls ( const char * file )

Gets an iterator that lists all extended attribute of a file.

Parameters:

[in] file The filename to retrieve the extended attribute list from.

Returns:: an iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Bool eina_xattr_set	(	const char *	file,
		const char *	attribute,
		const void *	data,
		ssize_t	length,
		Eina_Xattr_Flags	flags
	)

Sets an extended attribute on a file.

Parameters:

[in]	file	The file to set the extended attribute to.
[in]	attribute	The attribute to set.
[in]	data	The data to set.
[in]	length	The length of the data to set.
[in]	flags	Define the set policy.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :: 1.1

Since :: 2.3

char* eina_xattr_string_get	(	const char *	file,
		const char *	attribute
	)

Gets a string from an extended attribute properties.

Parameters:

[in]	file	The file to get the string from.
[in]	attribute	The attribute to get.

Returns:: A valid string on success, NULL otherwise.

This call check that the string is properly NULL-terminated before returning it.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Bool eina_xattr_string_set	(	const char *	file,
		const char *	attribute,
		const char *	data,
		Eina_Xattr_Flags	flags
	)

Sets a string as a extended attribute properties.

Parameters:

[in]	file	The file to set the string to.
[in]	attribute	The attribute to set.
[in]	data	The NULL-terminated string to set.
[in]	flags	Define the set policy.

Returns:: EINA_TRUE on success, EINA_FALSE otherwise.

Since (EFL) :: 1.1

Since :: 2.3

Eina_Iterator* eina_xattr_value_fd_ls ( int fd )

Gets an iterator that list all extended attribute value related to a fd.

Parameters:

[in] fd The file descriptor to retrieve the extended attribute list from.

Returns:: An iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need. The iterator will provide an Eina_Xattr structure.

Since (EFL) :: 1.2

Since :: 2.3

Eina_Iterator* eina_xattr_value_ls ( const char * file )

Gets an iterator that list all extended attribute value related to a fd.

Parameters:

[in] file The filename to retrieve the extended attribute list from.

Returns:: An iterator.

The iterator will not allocate any data during the iteration step, so you need to copy them yourself if you need. The iterator will provide an Eina_Xattr structure.

Since (EFL) :: 1.2

Since :: 2.3

Functions

Defines

Define Documentation

Enumeration Type Documentation

Function Documentation