pandas.api.extensions.ExtensionArray.insert#

ExtensionArray.insert(loc, item)[source]#

Insert an item at the given position.

Parameters:
locint

Index where the item needs to be inserted.

itemscalar-like

Value to be inserted.

Returns:
ExtensionArray

With item inserted at loc.

See also

Index.insert

Make new Index inserting new item at location.

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