ANSI Environment Function

char *envz_entry(const char *envz, size_t envz_len, const char *name);

Internationalization (I18n) Function Overview

The envz_entry function finds the entry in envz with the name name, and returns a pointer to the whole entry--that is, the argz element which begins with name followed by a '=' character. If there is no entry with that name, 0 is returned.

For more specifics on the argz and envz family of functions, see Argz and Envz vectors in the GNU manual.

I18n Issues

There is no ANSI wide character version of this function. The parameters will have to be converted to multibyte UTF-8 characters and then the envz_entry function can be used. Similarly, the return value will then need to be converted from multibyte UTF-8 characters back to wide characters.

Recommended Replacements*

ANSI UTF-8	envz_entry
ANSI UTF-16	convert and use envz_entry
	(See "I18n Issues" above)

ANSI Environment and Command Line Argument Functions