NAME

SYNOPSIS

char **
PhkArgvParse(const char *s, int comment);

void
PhkArgvFree(char **);

DESCRIPTION

PhkArgvParse Splits the string s into individual arguments and returns an argv vector.

The first element of the returned vector is non-NULL it contains an error message and the conversion was a failure.

Otherwise the remainder of the vector contains the parsed arguments, terminated by a NULL element.

The returned argv and the storage for the arguments are allocated with malloc(3) but should only be freed with the PhkArgvFree function.

If the comment argument is non-zero, any argument starting with a '#' character will terminate the parsing, rendering the remainder of the input string a comment.

Arguments can be included in double quotes '"' and the usual backslash escapes are recognized and converted.

EXAMPLES

#include "phk_argv.h"

[...]

char **av;
char *p;

[...]

av = PhkArgvParse(p, 0);
if (av[0] != NULL)
	err(1, "Parse error: %s", av[0]);
for (i = 1; av[i] != NULL; i++)
	printf("av[%d] = %s\n", i, av[i]);
PhkArgvFree(av);

SEE ALSO

HISTORY