pandas.api.extensions.ExtensionArray.insert

ExtensionArray.insert(loc, item)[source]

Insert an item at the given position.

Parameters:

loc:int

item:scalar-like

Returns:

same type as self

Notes

This method should be both type and dtype-preserving. If the item cannot be held in an array of this type/dtype, either ValueError or TypeError should be raised.

The default implementation relies on _from_sequence to raise on invalid items.

Examples

>>> arr = pd.array([1, 2, 3])
>>> arr.insert(2, -1)
<IntegerArray>
[1, 2, -1, 3]
Length: 4, dtype: Int64