ANSI Command Line Argument Function

error_t argz_insert(char **argz, size_t *argz_len, char *before, const char *entry);

Internationalization (I18n) Function Overview

The argz_insert function inserts the string entry into the argz vector *argz at a point just before the existing element pointed to by before, reallocating *argz and updating *argz and *argz_len. If before is 0, entry is added to the end instead (as if by argz_add). Since the first element is in fact the same as *argz, passing in *argz as the value of before will result in entry being inserted at the beginning.

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 argz_insert function can be used.

Recommended Replacements*

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

ANSI Environment and Command Line Argument Functions