cudf.Index.difference#

Index.difference(other, sort=None)#

Return a new Index with elements from the index that are not in other.

This is the set difference of two Index objects.

Parameters:
otherIndex or array-like
sortFalse 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 cudf.

  • 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:
differenceIndex

Examples

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