string_to_tokens3

Usage

int string_to_tokens(arg_string, arg_array, array_size, separator)
char *arg_string;
char *arg_array[];
int array_size;
char *separator;

Overview

This function parses the string arg_string, placing pointers to the separator separated tokens into the elements of arg_array. The array is terminated with a null pointer. arg_array must contains at least array_size elements. Only the first array_size minus one tokens will be placed into arg_array. If there are more than array_size-1 tokens, the rest are ignored by this routine.

Diagnostics

This function returns the number of separator separated tokens that were found in arg_string. If arg_array or separator is NULL or array_size is less than 2, -1 is returned.