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_layout recognizes).

• characters (str or bytes) – Individual characters to be trimmed from the string.

• 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.

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.