Method partition

pandas/core/strings/accessor.py:1031–1120

Split the string at the first occurrence of `sep`. This method splits the string at the first occurrence of `sep`, and returns 3 elements containing the part before the separator, the separator itself, and the part after the separator. If the separator is no

(self, sep: str = " ", expand: bool = True)

    @forbid_nonstring_types(["bytes"])
    def partition(self, sep: str = " ", expand: bool = True):
        """
        Split the string at the first occurrence of `sep`.

        This method splits the string at the first occurrence of `sep`,
        and returns 3 elements containing the part before the separator,
        the separator itself, and the part after the separator.
        If the separator is not found, return 3 elements containing the string itself,
        followed by two empty strings.

        Parameters
        ----------
        sep : str, default whitespace
            String to split on.
        expand : bool, default True
            If True, return DataFrame/MultiIndex expanding dimensionality.
            If False, return Series/Index.

        Returns
        -------
        DataFrame/MultiIndex or Series/Index of objects
            Returns appropriate type based on `expand` parameter with strings
            split based on the `sep` parameter.

        See Also
        --------
        rpartition : Split the string at the last occurrence of `sep`.
        Series.str.split : Split strings around given separators.
        str.partition : Standard library version.

        Examples
        --------
        >>> s = pd.Series(["Linda van der Berg", "George Pitt-Rivers"])
        >>> s
        0    Linda van der Berg
        1    George Pitt-Rivers
        dtype: str

        >>> s.str.partition()
                0  1             2
        0   Linda     van der Berg
        1  George      Pitt-Rivers

        To partition by the last space instead of the first one:

        >>> s.str.rpartition()
                       0  1            2
        0  Linda van der            Berg
        1         George     Pitt-Rivers

        To partition by something different than a space:

        >>> s.str.partition("-")
                            0  1       2
        0  Linda van der Berg
        1         George Pitt  -  Rivers

        To return a Series containing tuples instead of a DataFrame: