Skip to main content
`Ctrl`+`K`

# pandas.Index.get_loc

Index.get_loc(key)

  Get integer location, slice or boolean mask for requested label.

  The return type depends on the characteristics of the index: an integer for a unique index, a slice for a monotonic index with duplicate entries, or a boolean mask for a non-monotonic index with duplicates.

  Parameters:
    key label

      The key to check its location if it is present in the index.

  Returns:
    int if unique index, slice if monotonic index, else mask

      Integer location, slice or boolean mask.

  See also

  `Index.get_slice_bound`

    Calculate slice bound that corresponds to given label.

  `Index.get_indexer`

    Computes indexer and mask for new index given the current index.

  `Index.get_non_unique`

    Returns indexer and masks for new index given the current index.

  `Index.get_indexer_for`

    Returns an indexer even when non-unique.

  Examples

      >>> unique_index = pd.Index(list("abc"))
      >>> unique_index.get_loc("b")
      1

      >>> monotonic_index = pd.Index(list("abbc"))
      >>> monotonic_index.get_loc("b")
      slice(1, 3, None)

      >>> non_monotonic_index = pd.Index(list("abcb"))
      >>> non_monotonic_index.get_loc("b")
      array([False,  True, False,  True])