ak.contents.EmptyArray
----------------------

.. py:module: ak.contents.EmptyArray

Defined in `awkward.contents.emptyarray <https://github.com/scikit-hep/awkward/blob/36da52cfa8846355c390beb6555eac1d31c27c26/src/awkward/contents/emptyarray.py>`__ on `line 50 <https://github.com/scikit-hep/awkward/blob/36da52cfa8846355c390beb6555eac1d31c27c26/src/awkward/contents/emptyarray.py#L50>`__.

.. py:class:: ak.contents.EmptyArray(self, *, parameters=None, backend=None)

An EmptyArray is used whenever an array's type is not known because it is empty
(such as data from :py:obj:`ak.ArrayBuilder` without enough sample points to resolve the
type).

Unlike all other Content subclasses, EmptyArray cannot contain any parameters
(parameter values are always None).

EmptyArray has no equivalent in Apache Arrow.

To illustrate how the constructor arguments are interpreted, the following is a
simplified implementation of ``__init__``, ``__len__``, and ``__getitem__``:

.. code-block:: python


    class EmptyArray(Content):
        def __init__(self):
            pass

        def __len__(self):
            return 0

        def __getitem__(self, where):
            if isinstance(where, int):
                assert False

            elif isinstance(where, slice) and where.step is None:
                return EmptyArray()

            elif isinstance(where, str):
                raise ValueError("field " + repr(where) + " not found")

            else:
                raise AssertionError(where)



.. _ak-contents-emptyarray-copy:

.. py:method:: ak.contents.EmptyArray.copy(self, *, parameters=UNSET, backend=UNSET)



.. _ak-contents-emptyarray-__copy__:

.. py:method:: ak.contents.EmptyArray.__copy__(self)



.. _ak-contents-emptyarray-__deepcopy__:

.. py:method:: ak.contents.EmptyArray.__deepcopy__(self, memo)



.. _ak-contents-emptyarray-simplified:

.. py:method:: ak.contents.EmptyArray.simplified(cls, *, parameters=None, backend=None)



.. _ak-contents-emptyarray-_form_with_key:

.. py:method:: ak.contents.EmptyArray._form_with_key(self, getkey)



.. _ak-contents-emptyarray-_form_with_key_path:

.. py:method:: ak.contents.EmptyArray._form_with_key_path(self, path)



.. _ak-contents-emptyarray-_to_buffers:

.. py:method:: ak.contents.EmptyArray._to_buffers(self, form, getkey, container, backend, byteorder)



.. _ak-contents-emptyarray-_to_typetracer:

.. py:method:: ak.contents.EmptyArray._to_typetracer(self, forget_length)



.. _ak-contents-emptyarray-_touch_data:

.. py:method:: ak.contents.EmptyArray._touch_data(self, recursive)



.. _ak-contents-emptyarray-_touch_shape:

.. py:method:: ak.contents.EmptyArray._touch_shape(self, recursive)



.. _ak-contents-emptyarray-length:

.. py:attribute:: ak.contents.EmptyArray.length



.. _ak-contents-emptyarray-__repr__:

.. py:method:: ak.contents.EmptyArray.__repr__(self)



.. _ak-contents-emptyarray-_repr:

.. py:method:: ak.contents.EmptyArray._repr(self, indent, pre, post)



.. _ak-contents-emptyarray-to_numpyarray:

.. py:method:: ak.contents.EmptyArray.to_NumpyArray(self, dtype, backend=None)



.. _ak-contents-emptyarray-__iter__:

.. py:method:: ak.contents.EmptyArray.__iter__(self)



.. _ak-contents-emptyarray-_getitem_nothing:

.. py:method:: ak.contents.EmptyArray._getitem_nothing(self)



.. _ak-contents-emptyarray-_is_getitem_at_placeholder:

.. py:method:: ak.contents.EmptyArray._is_getitem_at_placeholder(self)



.. _ak-contents-emptyarray-_is_getitem_at_virtual:

.. py:method:: ak.contents.EmptyArray._is_getitem_at_virtual(self)



.. _ak-contents-emptyarray-_getitem_at:

.. py:method:: ak.contents.EmptyArray._getitem_at(self, where)



.. _ak-contents-emptyarray-_getitem_range:

.. py:method:: ak.contents.EmptyArray._getitem_range(self, start, stop)



.. _ak-contents-emptyarray-_getitem_field:

.. py:method:: ak.contents.EmptyArray._getitem_field(self, where, only_fields=())



.. _ak-contents-emptyarray-_getitem_fields:

.. py:method:: ak.contents.EmptyArray._getitem_fields(self, where, only_fields=())



.. _ak-contents-emptyarray-_carry:

.. py:method:: ak.contents.EmptyArray._carry(self, carry, allow_lazy)



.. _ak-contents-emptyarray-_getitem_next_jagged:

.. py:method:: ak.contents.EmptyArray._getitem_next_jagged(self, slicestarts, slicestops, slicecontent, tail)



.. _ak-contents-emptyarray-_getitem_next:

.. py:method:: ak.contents.EmptyArray._getitem_next(self, head, tail, advanced)



.. _ak-contents-emptyarray-_offsets_and_flattened:

.. py:method:: ak.contents.EmptyArray._offsets_and_flattened(self, axis, depth)



.. _ak-contents-emptyarray-_mergeable_next:

.. py:method:: ak.contents.EmptyArray._mergeable_next(self, other, mergebool)



.. _ak-contents-emptyarray-_mergemany:

.. py:method:: ak.contents.EmptyArray._mergemany(self, others)



.. _ak-contents-emptyarray-_fill_none:

.. py:method:: ak.contents.EmptyArray._fill_none(self, value)



.. _ak-contents-emptyarray-_local_index:

.. py:method:: ak.contents.EmptyArray._local_index(self, axis, depth)



.. _ak-contents-emptyarray-_numbers_to_type:

.. py:method:: ak.contents.EmptyArray._numbers_to_type(self, name, including_unknown)



.. _ak-contents-emptyarray-_is_unique:

.. py:method:: ak.contents.EmptyArray._is_unique(self, negaxis, starts, parents, outlength)



.. _ak-contents-emptyarray-_unique:

.. py:method:: ak.contents.EmptyArray._unique(self, negaxis, starts, parents, outlength)



.. _ak-contents-emptyarray-_argsort_next:

.. py:method:: ak.contents.EmptyArray._argsort_next(self, negaxis, starts, shifts, parents, outlength, ascending, stable)



.. _ak-contents-emptyarray-_sort_next:

.. py:method:: ak.contents.EmptyArray._sort_next(self, negaxis, starts, parents, outlength, ascending, stable)



.. _ak-contents-emptyarray-_combinations:

.. py:method:: ak.contents.EmptyArray._combinations(self, n, replacement, recordlookup, parameters, axis, depth)



.. _ak-contents-emptyarray-_reduce_next:

.. py:method:: ak.contents.EmptyArray._reduce_next(self, reducer, negaxis, starts, shifts, parents, outlength, mask, keepdims, behavior)



.. _ak-contents-emptyarray-_validity_error:

.. py:method:: ak.contents.EmptyArray._validity_error(self, path)



.. _ak-contents-emptyarray-_nbytes_part:

.. py:method:: ak.contents.EmptyArray._nbytes_part(self)



.. _ak-contents-emptyarray-_pad_none:

.. py:method:: ak.contents.EmptyArray._pad_none(self, target, axis, depth, clip)



.. _ak-contents-emptyarray-_to_arrow:

.. py:method:: ak.contents.EmptyArray._to_arrow(self, pyarrow, mask_node, validbytes, length, options)



.. _ak-contents-emptyarray-_to_cudf:

.. py:method:: ak.contents.EmptyArray._to_cudf(self, cudf, mask, length)



.. _ak-contents-emptyarray-_arrow_needs_option_type:

.. py:method:: ak.contents.EmptyArray._arrow_needs_option_type(cls)



.. _ak-contents-emptyarray-_to_backend_array:

.. py:method:: ak.contents.EmptyArray._to_backend_array(self, allow_missing, backend)



.. _ak-contents-emptyarray-_remove_structure:

.. py:method:: ak.contents.EmptyArray._remove_structure(self, backend, options)



.. _ak-contents-emptyarray-_recursively_apply:

.. py:method:: ak.contents.EmptyArray._recursively_apply(self, action, depth, depth_context, lateral_context, options)



.. _ak-contents-emptyarray-to_packed:

.. py:method:: ak.contents.EmptyArray.to_packed(self, recursive=True)



.. _ak-contents-emptyarray-_to_list:

.. py:method:: ak.contents.EmptyArray._to_list(self, behavior, json_conversions)



.. _ak-contents-emptyarray-_to_backend:

.. py:method:: ak.contents.EmptyArray._to_backend(self, backend)



.. _ak-contents-emptyarray-_materialize:

.. py:method:: ak.contents.EmptyArray._materialize(self)



.. _ak-contents-emptyarray-_is_all_materialized:

.. py:attribute:: ak.contents.EmptyArray._is_all_materialized



.. _ak-contents-emptyarray-_is_any_materialized:

.. py:attribute:: ak.contents.EmptyArray._is_any_materialized



.. _ak-contents-emptyarray-_is_equal_to:

.. py:method:: ak.contents.EmptyArray._is_equal_to(self, other, index_dtype, numpyarray, all_parameters)