Stdlib.h functions.

This header provides functions ported from Unix in stdlib.h. More...

Macros
#define	HAVE_REALPATH   1

Functions
int	setenv (const char *name, const char *value, int overwrite)
	Create, modify, or remove environment variables. More...
int	unsetenv (const char *name)
	Remove environment variables. More...
char *	mkdtemp (char *__template)
	create an unique temporary directory More...
int	mkstemps (char *__template, int suffixlen)
	Create a unique temporary file name with a suffix. More...
char *	realpath (const char *file_name, char *resolved_name)
	Return an absolute or full path name for a specified relative path name. More...

Detailed Description

This header provides functions ported from Unix in stdlib.h.

Function Documentation

setenv()

int setenv	(	const char *	name,
		const char *	value,
		int	overwrite
	)

Create, modify, or remove environment variables.

Parameters

name	The name of the environment variable.
value	The value of the environment variable to set.
overwrite	0 to let the environment variable unchanged, 1 otherwise.

Returns

0 on success, -1 otherwise.

Add the new environment variable name or modify its value if it exists, and set it to value. Environment variables define the environment in which a process executes. If value is NULL, the variable is removed (unset) and that call is equivalent to unsetenv().If the environment variable named by name already exists and the value of overwrite is 0, the function shall return success and the environment shall remain unchanged. If the function succeeds, it returns 0, otherwise it returns -1.

Conformity: Non applicable.

Supported OS: Windows XP.

Referenced by ecore_drm_tty_open(), ecore_wl2_display_create(), and unsetenv().

unsetenv()

int unsetenv

(

const char *

name

)

Remove environment variables.

Parameters

name	The name of the environment variable.

Returns

0 on success, -1 otherwise.

Remove the new environment variable name if it exists. That function is equivalent to setenv() with its second parameter to NULL and the third to 1. If the function succeeds, it returns 0, otherwise it returns -1.

Conformity: Non applicable.

Supported OS: Windows XP.

References setenv().

Referenced by ecore_drm_tty_close(), and ecore_fork_reset().

mkdtemp()

char* mkdtemp

(

char *

__template

)

create an unique temporary directory

Since

1.8.0

mkstemps()

int mkstemps	(	char *	__template,
		int	suffixlen
	)

Create a unique temporary file name with a suffix.

Parameters

__template	Template of the file to create.
suffixlen	Length of the suffix following the 'XXXXXX' placeholder.

Returns

A file descriptor on success, -1 otherwise.

Since

1.10.0

realpath()

char* realpath	(	const char *	file_name,
		char *	resolved_name
	)

Return an absolute or full path name for a specified relative path name.

Parameters

file_name	The absolute path name.
resolved_name	The relative path name.

Returns

NULL on failure, a pointer to the absolute path name otherwise.

The function expands the relative path name file_name to its fully qualified or absolute path and store it in the buffer pointed by resolved_name. The buffer is at most PATH_MAX bytes long. If resolved_name is NULL, malloc() is used to allocate a buffer of sufficient length to hold the path name. In that case, it is the responsibility of the caller to free this buffer with free().

That function can be used to obtain the absolute path name for relative paths (relPath) that include "./" or "../" in their names.

On Windows XP, errno is set in the following cases:

• EACCESS: if file_name can not be accessed.
• EINVAL: if file_name is NULL.
• ENAMETOOLONG: if the path name is too long.
• ENOENT: file_name does not exist
• ENOMEM: if memory allocation fails.

Conformity: None.

Supported OS: Windows XP.

Referenced by eina_prefix_new().