split_set

Splits string into a number of tokens not containing any of the characters in delimiter.

A token is the (possibly empty) longest string that does not contain any of the characters in delimiters. If max_tokens is reached, the remainder is appended to the last token.

For example the result of g_strsplit_set ("abc:def/ghi", ":/", -1) is a null-terminated vector containing the three strings "abc", "def", and "ghi".

The result of g_strsplit_set ("gchar:def/ghi:", ":/", -1) is a null-terminated vector containing the four strings "", "def", "ghi", and "".

As a special case, the result of splitting the empty string "" is an empty vector, not a vector containing a single string. The reason for this special case is that being able to represent a empty vector is typically more useful than consistent handling of empty elements. If you do need to represent empty elements, you'll need to check for the empty string before calling split_set .

Note that this function works on bytes not characters, so it can't be used to delimit UTF-8 strings for anything but ASCII characters.

Parameters:

delimiters	A nul-terminated string containing bytes that are used to split the string.
max_tokens	The maximum number of tokens to split string into. If this is less than 1, the string is split completely
string	The string to be tokenized

Returns:

a newly-allocated null-terminated array of strings. Use strfreev to free it.