ak.str.split_whitespace#

Defined in awkward.operations.str.akstr_split_whitespace on line 13.

ak.str.split_whitespace(array, *, max_splits=None, reverse=False, highlevel=True, behavior=None, attrs=None)#

Parameters:

array – Array-like data (anything ak.to_layout recognizes).
max_splits (None or int) – Maximum number of splits for each input value. If None, unlimited.
reverse (bool) – If True, start splitting from the end of each input value; otherwise, start splitting from the beginning of each value. This flag only has an effect if max_splits is not None.
highlevel (bool) – If True, return an ak.Array; otherwise, return a low-level ak.contents.Content subclass.
behavior (None or dict) – Custom ak.behavior for the output array, if high-level.
attrs (None or dict) – Custom attributes for the output array, if high-level.

Splits any string or bytestring-valued data into a list of substrings according to any non-zero length sequence of whitespace characters.

For strings, a split is performed for every sequence of Unicode whitespace characters; for bytestrings, splitting is performed for sequences of ascii whitespace characters.

The max_splits, and reverse arguments are scalars; they cannot be different for each string/bytestring in the sample.

Note: this function does not raise an error if the array does not contain any string or bytestring data.

Requires the pyarrow library and calls pyarrow.compute.utf8_split_whitespace or pyarrow.compute.ascii_split_whitespace on strings and bytestrings, respectively.