ak.str.join_element_wise#

Defined in awkward.operations.str.akstr_join_element_wise on line 21.

ak.str.join_element_wise(*arrays, highlevel=True, behavior=None, attrs=None)#
Parameters:
  • arrays – Array-like data (anything ak.to_layout recognizes).

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

Broadcasts and concatenates all but the last array of strings in arrays; the last is used as a separator.

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

Unlike Arrow’s binary_join_element_wise, this function has no null_handling and null_replacement arguments. This function’s behavior is like null_handling="emit_null" (Arrow’s default). The other cases can be implemented with Awkward slices, ak.drop_none, and ak.fill_none.

See also: ak.str.join.