pandas.api.extensions.ExtensionArray.insert — pandas 2.2.3 documentation (original) (raw)

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

Insert an item at the given position.

Parameters:

locint

itemscalar-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) [1, 2, -1, 3] Length: 4, dtype: Int64