Zen API

- Home
- Topics
- Types
- Files

All Classes Files Functions Variables Typedefs Friends Macros Modules Pages

kStatus kString_Split | ( | kString | str,
|  | const kChar * | delimiters,
|  | kArrayList * | tokens,
|  | kAlloc | allocator
| ) |  |

Splits this string into substrings using the supplied delimiters.

When using this method, all delimiter instances will result in the creation of additional output tokens, even if the output tokens are empty (e.g., multiple, successive delimiters). Use the kString_SplitEx method if control over this behaviour is required.

This function currently supports delimiters only within the ASCII character range.

Parameters

  str | String object.
  delimiters | Null-terminated string containing delimiter characters.
  tokens | Receives a list substrings.
  allocator | Memory allocator (or kNULL for default).

Returns
  Operation status.