ak.from_iter
------------

Defined in `awkward.operations.convert <https://github.com/scikit-hep/awkward-1.0/blob/80bbef0738a6b7928333d7c705ee1b359991de5b/src/awkward/operations/convert.py>`__ on `line 829 <https://github.com/scikit-hep/awkward-1.0/blob/80bbef0738a6b7928333d7c705ee1b359991de5b/src/awkward/operations/convert.py#L829>`__.

.. py:function:: ak.from_iter(iterable, highlevel=True, behavior=None, allow_record=True, initial=1024, resize=1.5)


    :param iterable: Data to convert into an Awkward Array.
    :type iterable: Python iterable
    :param highlevel: If True, return an :py:obj:`ak.Array`; otherwise, return
                  a low-level :py:obj:`ak.layout.Content` subclass.
    :type highlevel: bool
    :param behavior: Custom :py:obj:`ak.behavior` for the output array, if
                 high-level.
    :type behavior: None or dict
    :param allow_record: If True, the outermost element may be a record
                     (returning :py:obj:`ak.Record` or :py:obj:`ak.layout.Record` type, depending on
                     ``highlevel``); if False, the outermost element must be an array.
    :type allow_record: bool
    :param initial: Initial size (in bytes) of buffers used by
                :py:obj:`ak.layout.ArrayBuilder` (see :py:obj:`ak.layout.ArrayBuilderOptions`).
    :type initial: int
    :param resize: Resize multiplier for buffers used by
               :py:obj:`ak.layout.ArrayBuilder` (see :py:obj:`ak.layout.ArrayBuilderOptions`);
               should be strictly greater than 1.
    :type resize: float

Converts Python data into an Awkward Array.

Internally, this function uses :py:obj:`ak.layout.ArrayBuilder` (see the high-level
:py:obj:`ak.ArrayBuilder` documentation for a more complete description), so it
has the same flexibility and the same constraints. Any heterogeneous
and deeply nested Python data can be converted, but the output will never
have regular-typed array lengths.

The following Python types are supported.

   * bool, including ``np.bool_``: converted into :py:obj:`ak.layout.NumpyArray`.
   * int, including ``np.integer``: converted into :py:obj:`ak.layout.NumpyArray`.
   * float, including ``np.floating``: converted into :py:obj:`ak.layout.NumpyArray`.
   * bytes: converted into :py:obj:`ak.layout.ListOffsetArray` with parameter
     ``"__array__"`` equal to ``"bytestring"`` (unencoded bytes).
   * str: converted into :py:obj:`ak.layout.ListOffsetArray` with parameter
     ``"__array__"`` equal to ``"string"`` (UTF-8 encoded string).
   * tuple: converted into :py:obj:`ak.layout.RecordArray` without field names
     (i.e. homogeneously typed, uniform sized tuples).
   * dict: converted into :py:obj:`ak.layout.RecordArray` with field names
     (i.e. homogeneously typed records with the same sets of fields).
   * iterable, including np.ndarray: converted into
     :py:obj:`ak.layout.ListOffsetArray`.

See also :py:obj:`ak.to_list`.

