pandas.Index.difference — pandas 3.0.0.dev0+2100.gf496acffcc documentation (original) (raw)

final Index.difference(other, sort=None)[source]#

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

This is the set difference of two Index objects.

Parameters:

otherIndex or array-like

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

sortbool 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.

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')