pandas.Series.searchsorted

Series.searchsorted(self, value, side='left', sorter=None) [source]

Найти индексы, куда следует вставить элементы, чтобы сохранить порядок.

Найти индексы в отсортированной серии self такие, что, если соответствующие элементы в value были вставлены перед индексами, порядок self сохранялся бы.

Параметры:

value : array_like Значения для вставки в self. side : {‘left’, ‘right’}, optional Если ‘left’, возвращается индекс первой подходящей позиции. Если ‘right’, возвращается последний такой индекс. Если подходящий индекс отсутствует, возвращается либо 0, либо N (где N — длина self). sorter : 1-D array_like, optional Необязательный массив целочисленных индексов, которые сортируют self в порядке возрастания. Обычно они являются результатом np.argsort.

Возвращает:

int или массив int Скалярное или массивное значение индексов вставки с той же формой, что и value. Изменено в версии 0.24.0: Если value является скаляром, теперь всегда возвращается int. Ранее скалярные входные данные возвращали массив из 1 элемента для Series и Categorical.

См. также

numpy.searchsorted

Примечания

Для поиска необходимых точек вставки используется бинарный поиск.

Примеры

>>> x = pd.Series([1, 2, 3])
>>> x
0    1
1    2
2    3
dtype: int64

>>> x.searchsorted(4)
3

>>> x.searchsorted([0, 4])
array([0, 3])

>>> x.searchsorted([1, 3], side='left')
array([0, 2])

>>> x.searchsorted([1, 3], side='right')
array([1, 3])

>>> x = pd.Categorical(['apple', 'bread', 'bread',
                        'cheese', 'milk'], ordered=True)
[apple, bread, bread, cheese, milk]
Categories (4, object): [apple < bread < cheese < milk]

>>> x.searchsorted('bread')
1

>>> x.searchsorted(['bread'], side='right')
array([3])