💾 Archived View for tris.fyi › pydoc › _bisect captured on 2023-01-29 at 03:40:49. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

_bisect

Bisection algorithms.

This module provides support for maintaining a list in sorted order without
having to sort the list after each insertion. For long lists of items with
expensive comparison operations, this can be an improvement over the more
common approach.

Functions

bisect_left

bisect_left(a, x, lo=0, hi=None, *, key=None)

  Return the index where to insert item x in list a, assuming a is sorted.

  The return value i is such that all e in a[:i] have e < x, and all e in
  a[i:] have e >= x.  So if x already appears in the list, a.insert(i, x) will
  insert just before the leftmost x already there.

  Optional args lo (default 0) and hi (default len(a)) bound the
  slice of a to be searched.

bisect_right

bisect_right(a, x, lo=0, hi=None, *, key=None)

  Return the index where to insert item x in list a, assuming a is sorted.

  The return value i is such that all e in a[:i] have e <= x, and all e in
  a[i:] have e > x.  So if x already appears in the list, a.insert(i, x) will
  insert just after the rightmost x already there.

  Optional args lo (default 0) and hi (default len(a)) bound the
  slice of a to be searched.

insort_left

insort_left(a, x, lo=0, hi=None, *, key=None)

  Insert item x in list a, and keep it sorted assuming a is sorted.

  If x is already in a, insert it to the left of the leftmost x.

  Optional args lo (default 0) and hi (default len(a)) bound the
  slice of a to be searched.

insort_right

insort_right(a, x, lo=0, hi=None, *, key=None)

  Insert item x in list a, and keep it sorted assuming a is sorted.

  If x is already in a, insert it to the right of the rightmost x.

  Optional args lo (default 0) and hi (default len(a)) bound the
  slice of a to be searched.