char** axl_stream_split ( const char *  chunk,
int  separator_num,
  ... 
)

Allows to split the provided chunk, into several pieces that are separated by the separator (or separators) provided.

The function will try to split the chunk provide using the separator provided, and optionally, all separators provided.

Here is an example:

 char ** result;

 // split the provided value using the ':', ';' and ',' as separators.
 result = axl_stream_split (value, 3, ":", ";", ",");

The value returned must be deallocated using axl_stream_freev.

Parameters:
chunk The chunk to split.
separator_num The number os separators to be used while spliting the chunk.
Returns:
A newly allocated string, that must be deallocated by using axl_stream_freev. The function will return a NULL if the chunk or the separators provided are NULL.