This function extracts all sub-strings separated by a given character from the supplied string and returns them in an array of dynamically allocated strings. The delimiter character itself is not included in the returned strings.

Delimiter characters that are preceded by " $\setminus$" are not used as delimiters but are included in the returned word instead (without the " $\setminus$" ).

char $\ast$$\ast$astChrSplitC( const char $\ast$str, char c, int $\ast$n )

str

c

n

astChrSplitC()

• A NULL pointer is returned if this function is invoked with the global error status set or if it should fail for any reason, or if the supplied string contains no words.