Skip to main content
`Ctrl`+`K`

# pandas.Index.difference

final Index.difference(other, sort=None)

  Return a new Index with elements of index not in other.

  This is the set difference of two Index objects.

  Parameters:
    other Index or array-like

      Index object or an array-like object containing elements to be compared with the elements of the original Index.

    sort bool or None, default None

      Whether to sort the resulting index. By default, the values are attempted to be sorted, but any TypeError from incomparable elements is caught by pandas.

      - None : Attempt to sort the result, but catch any TypeErrors from comparing incomparable elements.

      - False : Do not sort the result.

      - True : Sort the result (which may raise TypeError).

  Returns:
    Index

      Returns a new Index object containing elements that are in the original Index but not in the other Index.

  See also

  `Index.symmetric_difference`

    Compute the symmetric difference of two Index objects.

  `Index.intersection`

    Form the intersection of two Index objects.

  Examples

      >>> idx1 = pd.Index([2, 1, 3, 4])
      >>> idx2 = pd.Index([3, 4, 5, 6])
      >>> idx1.difference(idx2)
      Index([1, 2], dtype='int64')
      >>> idx1.difference(idx2, sort=False)
      Index([2, 1], dtype='int64')