Skip to main content
`Ctrl`+`K`

# pandas.Series.str.slice_replace

Series.str.slice_replace(start=None, stop=None, repl=None)

  Replace a positional slice of a string with another value.

  This function allows replacing specific parts of a string in a Series or Index by specifying start and stop positions. It is useful for modifying substrings in a controlled way, such as updating sections of text based on their positions or patterns.

  Parameters:
    start int, optional

      Left index position to use for the slice. If not specified (None), the slice is unbounded on the left, i.e. slice from the start of the string.

    stop int, optional

      Right index position to use for the slice. If not specified (None), the slice is unbounded on the right, i.e. slice until the end of the string.

    repl str, optional

      String for replacement. If not specified (None), the sliced region is replaced with an empty string.

  Returns:
    Series or Index

      Same type as the original object.

  See also

  `Series.str.slice`

    Just slicing without replacement.

  Examples

      >>> s = pd.Series(["a", "ab", "abc", "abdc", "abcde"])
      >>> s
      0        a
      1       ab
      2      abc
      3     abdc
      4    abcde
      dtype: str

  Specify just start, meaning replace start until the end of the string with repl.

      >>> s.str.slice_replace(1, repl="X")
      0    aX
      1    aX
      2    aX
      3    aX
      4    aX
      dtype: str

  Specify just stop, meaning the start of the string to stop is replaced with repl, and the rest of the string is included.

      >>> s.str.slice_replace(stop=2, repl="X")
      0       X
      1       X
      2      Xc
      3     Xdc
      4    Xcde
      dtype: str

  Specify start and stop, meaning the slice from start to stop is replaced with repl. Everything before or after start and stop is included as is.

      >>> s.str.slice_replace(start=1, stop=3, repl="X")
      0      aX
      1      aX
      2      aX
      3     aXc
      4    aXde
      dtype: str