ak.str.center#

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

ak.str.center(array, width, padding=' ', *, highlevel=True, behavior=None, attrs=None)#

Parameters:

array – Array-like data (anything ak.to_layout recognizes).
width (int) – Desired string length.
padding (str or bytes) – What to pad the string with. Should be one codepoint or byte.
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.

Replaces any string or bytestring-valued data with centered strings/bytestrings of a given width, padding both sides with the given padding codepoint or byte.

If the data are strings, width is measured in codepoints and padding must be one codepoint.

If the data are bytestrings, width is measured in bytes and padding must be one byte.

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_center or pyarrow.compute.ascii_center on strings and bytestrings, respectively.