NAME

SYNOPSIS

Split string and add tokens to the string array
svect *
split(const char *string, const char *delim, int flags);

int
splitf(svect *, const char *string, const char *delim, int flags);

int
splitquotable(svect *, const char *string);

Join the array tokens together
char *
join(char **, const char *delimiter);

char *
sjoin(svect *, const char *delimiter);

Stand-alone network/mask splitting function
int
split_network(const char *ip_mask, unsigned int *ip, unsigned int *mask);

DESCRIPTION

int splitf(svect *, const char *string, const char *delim, int flags) is the basic splitting function. string specifies the source string. delim specifies the delimiter to be used to split string into tokens. flags is the bitwise OR of the following values:

Return value is the number of tokens recognized and added to the vector, or -1 in case of an error caused by memory shortage or regular expressions handling failure.

svect * split(const char *string, const char *set, int flags) is identical to the splitf() in one exception that it will create a new svect * structure for you. The structure will always be allocated, but it can contain no data if splitf() will be unable to find any tokens.

int splitquotable(svect *sl, const char *string) is the function that recognizes single and double quotes and splits string according to them. There is a small hack that allows to know whether this or that piece of string (token) was originally inside the double or single quotes. The character (byte) right after the end of string within the list sl->list[N][sl->lens[N] + 1] will contain the ' ', '1' or '2' if the appropriate token was originaly found within the unquoted text, single or double quotes, respectively.

To join vector elements together, sjoin(svect *, const char *delimiter) function may be called. Another call, join(char **list, const char *delimiter), may be required to join the char ** values together without using an intermediate svect * structure.

int split_network(const char *ip_mask, unsigned int *ip, unsigned int *mask) used to split IP/Mask strings to binary IP address and mask. Both ip and mask arguments should be supplied. They will be filled with recognized ip address and mask in network byte order. Refer to byteorder(3) or ntohl(3). split_network() regognizes the standart forms of ip address/mask pairs:

	a.b.c.d/masklen
	a.b.c.d/0xHEXMASK
	a.b.c.d 0xHEXMASK
	a.b.c.d/a.b.c.d
	a.b.c.d a.b.c.d
	or, more common
	a[.[b[.c[.d]]]]/a.b[.c[.d]]]
	and
	a[.[b[.c[.d]]]] a.b[.c[.d]]]

EXAMPLES

void removeMultipleSpaces(const char *string) {
	svect *sl;

	/* Split string="some   bad   string"
	 * and add tokens to the vector
	 */
	sl = split(string, NULL, 0);

	/* And join them together to form
	 * "some bad string"
	 */
	printf("%s\n", sjoin(sl, " "));

	/* Destroy the string vector */
	sfree(sl);
};

Split according to quotes

SEE ALSO

AUTHORS