ak.singletons — Awkward Array documentation

# ak.singletons

Defined in awkward.operations.structure on line 2969.

ak.singletons(array, highlevel=True, behavior=None)
  Parameters:

    - array – Data to wrap in lists of length 1 if present and length 0 if missing (None).

    - highlevel (bool) – If True, return an `ak.Array`; otherwise, return a low-level `ak.layout.Content` subclass.

    - behavior (None or dict) – Custom `ak.behavior` for the output array, if high-level.

Returns a singleton list (length 1) wrapping each non-missing value and an empty list (length 0) in place of each missing value.

For example,

    >>> array = ak.Array([1.1, 2.2, None, 3.3, None, None, 4.4, 5.5])
    >>> print(ak.singletons(array))
    [[1.1], [2.2], [], [3.3], [], [], [4.4], [5.5]]

See `ak.firsts` to invert this function.