legate.core.Runtime.create_struct_array#

Runtime.create_struct_array(
self,
tuple fields,
LogicalStore null_mask=None,
) StructLogicalArray#

Creates a StructLogicalArray.

This call can block if any array from fields or null_mask are unbound.

Parameters:
  • fields (tuple[LogicalArray]) – The tuple of arrays representing each field in the struct.

  • null_mask (LogicalStore) – The store representing the null mask for the StructLogicalArray.

Returns:

The newly created array.

Return type:

StructLogicalArray

Raises:

ValueError – If null_mask is not of boolean type, if given. Or if any of fields or null_mask have differing shapes. Or if any of fields or null_mask are not top-level stores.