add drop_nulls (#318)

data-apis · Nov 14, 2023 · 2e9687b · 2e9687b
1 parent 76ad5b0
commit 2e9687b
Showing 1 changed file with 22 additions and 0 deletions.
diff --git a/spec/API_specification/dataframe_api/dataframe_object.py b/spec/API_specification/dataframe_api/dataframe_object.py
@@ -854,6 +854,28 @@ def fill_null(
         """
         ...
 
+    def drop_nulls(
+        self,
+        *,
+        column_names: list[str] | None = None,
+    ) -> Self:
+        """Drop rows containing null values.
+
+        Parameters
+        ----------
+        column_names : list[str] | None
+            A list of column names to consider when dropping nulls.
+            If ``None``, all columns will be considered.
+
+        Raises
+        ------
+        KeyError
+            If ``column_names`` contains a column name that is not present in
+            the dataframe.
+
+        """
+        ...
+
     def to_array(self, dtype: DType) -> Any:
         """Convert to array-API-compliant object.