TF 2.0 is out! Get hands-on practice at TF World, Oct 28-31. Use code TF20 for 20% off select passes. Register now


TensorFlow 1 version View source on GitHub

Split elements of input based on sep into a RaggedTensor.


  • tf.compat.v2.strings.split

Used in the guide:

Used in the tutorials:

Let N be the size of input (typically N will be the batch size). Split each element of input based on sep and return a SparseTensor or RaggedTensor containing the split tokens. Empty tokens are ignored.


tf.strings.split('hello world')
<Tensor ['hello', 'world']>
tf.strings.split(['hello world', 'a b c'])
<tf.RaggedTensor [['hello', 'world'], ['a', 'b', 'c']]>

If sep is given, consecutive delimiters are not grouped together and are deemed to delimit empty strings. For example, input of "1<>2<><>3" and sep of "<>" returns ["1", "2", "", "3"]. If sep is None or an empty string, consecutive whitespace are regarded as a single separator, and the result will contain no empty strings at the start or end if the string has leading or trailing whitespace.

Note that the above mentioned behavior matches python's str.split.


  • input: A string Tensor of rank N, the strings to split. If rank(input) is not known statically, then it is assumed to be 1.
  • sep: 0-D string Tensor, the delimiter string.
  • maxsplit: An int. If maxsplit > 0, limit of the split of the result.
  • name: A name for the operation (optional).


  • ValueError: If sep is not a string.


A RaggedTensor of rank N+1, the strings split according to the delimiter.