a
    yn„fì  ã                   @  sŠ   d dl mZ d dlZd dlmZ d dlmZmZm	Z	 d dl
mZ d dlmZ d dlmZ dZe ¡ Zeƒ dd
dddœdd„ƒZdd„ ZdS )é    )ÚannotationsN)Úhigh_level_function)ÚHighLevelContextÚensure_same_backendÚmaybe_posaxis)ÚNumpyMetadata)Úregularize_axis)Ú	AxisError)Ú	fill_noneéÿÿÿÿT)Ú	highlevelÚbehaviorÚattrsc                c  s   | |fV  t | |||||ƒS )a£  
    Args:
        array: Array-like data (anything #ak.to_layout recognizes).
        value: Data with which to replace None.
        axis (None or int): If None, replace all None values in the array
            with the given value; if an int, The dimension at which this
            operation is applied. The outermost dimension is `0`, followed
            by `1`, etc., and negative values count backward from the
            innermost: `-1` is the innermost  dimension, `-2` is the next
            level up, etc.
        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.

    Replaces missing values (None) with a given `value`.

    For example, in the following

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

    The None values could be replaced with `0` by

        >>> ak.fill_none(array, 0)
        <Array [[1.1, 0, 2.2], [], [0, 3.3, 4.4]] type='3 * var * float64'>

    The replacement value doesn't strictly need the same type as the
    surrounding data. For example, the None values could also be replaced
    by a string.

        >>> ak.fill_none(array, "hi")
        <Array [[1.1, 'hi', 2.2], [], ['hi', ...]] type='3 * var * union[float64, s...'>

    The list content now has a union type:

        >>> ak.fill_none(array, "hi").type.show()
        3 * var * union[
            float64,
            string
        ]

    The values could be floating-point numbers or strings.
    )Ú_impl)ÚarrayÚvalueÚaxisr   r   r   © r   úb/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/awkward/operations/ak_fill_none.pyr
      s    0
r
   c           
        s  t ˆ ƒ‰ t||d��<}t|j| ddd�|j|dddddd�ƒ\}‰W d   ƒ n1 sV0    Y  tˆtjjƒr†ˆjˆj	ˆj	d … ‰n>tˆtj
jƒr¤ˆtjdf ‰n tjj|dddd	d	d� |j¡‰ˆ d u rÚ‡fd
d„}n‡ ‡fdd„}tj ||¡}	|j|	|d�S )N)r   r   TF)Úallow_recordÚallow_unknownzpass-through)r   r   Zuse_from_iterZprimitive_policyZstring_policyé   .Zpromotec                   s   | j rtj |ƒ ˆ ¡S d S )N)Ú	is_optionÚakÚ_dor
   )ÚlayoutZcontinuationÚkwargs)Úvalue_layoutr   r   Úactionj   s    z_impl.<locals>.actionc                   sp   t | ˆ |ƒ}|d urP|d |krP| jr4tj | ˆ¡S | jsF| jsF| jrJd S | S n| jrlt	dˆ › d|› d�ƒ‚d S )Nr   zaxis=z" exceeds the depth of this array (ú))
r   r   r   r   r
   Zis_unionZ	is_recordZ
is_indexedZis_leafr	   )r   Údepthr   Zposaxis©r   r   r   r   r   p   s    ÿ)r   )r   r   r   ÚunwrapÚ
isinstancer   ÚrecordZRecordr   ÚatÚcontentsZContentÚnpZnewaxisÚ
operationsZ	to_layoutZ
to_backendÚbackendr   Zrecursively_applyÚwrap)
r   r   r   r   r   r   ÚctxZarray_layoutr   Úoutr   r!   r   r   G   s@    úþ&úù	r   )r   )Ú
__future__r   Zawkwardr   Zawkward._dispatchr   Zawkward._layoutr   r   r   Zawkward._nplikes.numpy_liker   Zawkward._regularizer   Zawkward.errorsr	   Ú__all__Úinstancer'   r
   r   r   r   r   r   Ú<module>   s   5