update

Author: zhangbowen-coder

pandas/core/frame.py

@@ -67,6 +67,7 @@
 )
 from pandas.util._decorators import (
     deprecate_nonkeyword_arguments,
+    doc,
     set_module,
 )
 from pandas.util._exceptions import (
@@ -7509,75 +7510,10 @@ def isna(self) -> DataFrame:
         result = self._constructor_from_mgr(res_mgr, axes=res_mgr.axes)
         return result.__finalize__(self, method="isna")
 
+    @doc(NDFrame.isna, klass=_shared_doc_kwargs["klass"])
     def isnull(self) -> DataFrame:
-        """DataFrame.isnull is an alias for DataFrame.isna.
-
-        Detect missing values.
-
-        Return a boolean same-sized object indicating if the values are NA.
-        NA values, such as None or :attr:`numpy.NaN`, gets mapped to True
-        values.
-        Everything else gets mapped to False values. Characters such as empty
-        strings ``''`` or :attr:`numpy.inf` are not considered NA values.
-
-        Returns
-        -------
-        Series/DataFrame
-            Mask of bool values for each element in Series/DataFrame
-            that indicates whether an element is an NA value.
-
-        See Also
-        --------
-        Series.isnull : Alias of isna.
-        DataFrame.isnull : Alias of isna.
-        Series.notna : Boolean inverse of isna.
-        DataFrame.notna : Boolean inverse of isna.
-        Series.dropna : Omit axes labels with missing values.
-        DataFrame.dropna : Omit axes labels with missing values.
-        isna : Top-level isna.
-
-        Examples
-        --------
-        Show which entries in a DataFrame are NA.
-
-        >>> df = pd.DataFrame(
-        ...     dict(
-        ...         age=[5, 6, np.nan],
-        ...         born=[
-        ...             pd.NaT,
-        ...             pd.Timestamp("1939-05-27"),
-        ...             pd.Timestamp("1940-04-25"),
-        ...         ],
-        ...         name=["Alfred", "Batman", ""],
-        ...         toy=[None, "Batmobile", "Joker"],
-        ...     )
-        ... )
-        >>> df
-           age       born    name        toy
-        0  5.0        NaT  Alfred        NaN
-        1  6.0 1939-05-27  Batman  Batmobile
-        2  NaN 1940-04-25              Joker
-
-        >>> df.isna()
-             age   born   name    toy
-        0  False   True  False   True
-        1  False  False  False  False
-        2   True  False  False  False
-
-        Show which entries in a Series are NA.
-
-        >>> ser = pd.Series([5, 6, np.nan])
-        >>> ser
-        0    5.0
-        1    6.0
-        2    NaN
-        dtype: float64
-
-        >>> ser.isna()
-        0    False
-        1    False
-        2     True
-        dtype: bool
+        """
+        DataFrame.isnull is an alias for DataFrame.isna.
         """
         return self.isna()
 
@@ -7652,75 +7588,10 @@ def notna(self) -> DataFrame:
         """
         return ~self.isna()
 
+    @doc(NDFrame.notna, klass=_shared_doc_kwargs["klass"])
     def notnull(self) -> DataFrame:
-        """DataFrame.notnull is an alias for DataFrame.notna.
-
-        Detect existing (non-missing) values.
-
-        Return a boolean same-sized object indicating if the values are not NA.
-        Non-missing values get mapped to True. Characters such as empty
-        strings ``''`` or :attr:`numpy.inf` are not considered NA values.
-        NA values, such as None or :attr:`numpy.NaN`, get mapped to False
-        values.
-
-        Returns
-        -------
-        Series/DataFrame
-            Mask of bool values for each element in Series/DataFrame
-            that indicates whether an element is not an NA value.
-
-        See Also
-        --------
-        Series.notnull : Alias of notna.
-        DataFrame.notnull : Alias of notna.
-        Series.isna : Boolean inverse of notna.
-        DataFrame.isna : Boolean inverse of notna.
-        Series.dropna : Omit axes labels with missing values.
-        DataFrame.dropna : Omit axes labels with missing values.
-        notna : Top-level notna.
-
-        Examples
-        --------
-        Show which entries in a DataFrame are not NA.
-
-        >>> df = pd.DataFrame(
-        ...     dict(
-        ...         age=[5, 6, np.nan],
-        ...         born=[
-        ...             pd.NaT,
-        ...             pd.Timestamp("1939-05-27"),
-        ...             pd.Timestamp("1940-04-25"),
-        ...         ],
-        ...         name=["Alfred", "Batman", ""],
-        ...         toy=[None, "Batmobile", "Joker"],
-        ...     )
-        ... )
-        >>> df
-           age       born    name        toy
-        0  5.0        NaT  Alfred        NaN
-        1  6.0 1939-05-27  Batman  Batmobile
-        2  NaN 1940-04-25              Joker
-
-        >>> df.notna()
-             age   born  name    toy
-        0   True  False  True  False
-        1   True   True  True   True
-        2  False   True  True   True
-
-        Show which entries in a Series are not NA.
-
-        >>> ser = pd.Series([5, 6, np.nan])
-        >>> ser
-        0    5.0
-        1    6.0
-        2    NaN
-        dtype: float64
-
-        >>> ser.notna()
-        0     True
-        1     True
-        2    False
-        dtype: bool
+        """
+        DataFrame.notnull is an alias for DataFrame.notna.
         """
         return ~self.isna()