Splits a string into a maximum of max_tokens
pieces, using the given delimiter
.
If max_tokens
is reached, the remainder of string
is appended to the last token.
As an example, the result of g_strsplit ("gchar:a
gchar:bc
gchar::d
:", ":", -1) is a
null-terminated vector containing the six strings "", "a", "bc", "", "d" 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.
delimiter |
a string which specifies the places at which to split the string. The delimiter is not included in any of the resulting strings,
unless |
max_tokens |
the maximum number of pieces to split |
string |
a string to split |
a newly-allocated null-terminated array of strings. Use strfreev to free it. |