Add DataFrame.unique_indices

spec/API_specification/dataframe_api/dataframe_object.py

@@ -740,6 +740,27 @@ def is_nan(self) -> DataFrame:
         """
         ...
 
+    def unique_indices(self, keys: Sequence[str], *, skip_nulls: bool = True) -> Column[int]:
+        """
+        Return indices corresponding to unique values across in selected columns.
+
+        Returns
+        -------
+        Column[int]
+            Indices corresponding to unique values.
+
+        Notes
+        -----
+        There are no ordering guarantees. In particular, if there are multiple
+        indices corresponding to the same unique value(s), there is no guarantee
+        about which one will appear in the result.
+        If the original column(s) contain multiple `'NaN'` values, then
+        only a single index corresponding to those values should be returned.
+        Likewise for null values (if ``skip_nulls=False``).
+        To get the unique values, you can do ``df.get_rows(df.unique_indices(keys))``.
+        """
+        ...
+
     def fill_nan(self, value: float | 'null', /) -> DataFrame:
         """
         Fill ``nan`` values with the given fill value.