ak.str.trim#
Defined in awkward.operations.str.akstr_trim on line 13.
- ak.str.trim(array, characters, *, highlevel=True, behavior=None, attrs=None)#
- Parameters:
array – Array-like data (anything
ak.to_layoutrecognizes).characters (str or bytes) – Individual characters to be trimmed from the string.
highlevel (bool) – If True, return an
ak.Array; otherwise, return a low-levelak.contents.Contentsubclass.behavior (None or dict) – Custom
ak.behaviorfor the output array, if high-level.attrs (None or dict) – Custom attributes for the output array, if high-level.
Removes any leading or trailing characters of characters from any string
or bytestring-valued data.
If the data are strings, characters are interpreted as unordered,
individual codepoints.
If the data are bytestrings, characters are interpreted as unordered,
individual bytes.
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_trim or pyarrow.compute.ascii_trim on strings and bytestrings, respectively.
See also: ak.str.trim_whitespace.