- API reference
- Index objects
- pandas.Index.take
pandas.Index.take#
- Index.take(indices,axis=0,allow_fill=True,fill_value=None,**kwargs)[source]#
Return a new Index of the values selected by the indices.
For internal compatibility with numpy arrays.
- Parameters:
- indicesarray-like
Indices to be taken.
- axisint, optional
The axis over which to select values, always 0.
- allow_fillbool, default True
- fill_valuescalar, default None
If allow_fill=True and fill_value is not None, indices specified by-1 are regarded as NA. If Index doesn’t hold NA, raise ValueError.
- Returns:
- Index
An index formed of elements at the given indices. Will be the sametype as self, except for RangeIndex.
See also
numpy.ndarray.take
Return an array formed from the elements of a at the given indices.
Examples
>>>idx=pd.Index(['a','b','c'])>>>idx.take([2,2,1,2])Index(['c', 'c', 'b', 'c'], dtype='object')
On this page