Skip to main content
`Ctrl`+`K`

# pandas.Series.str.pad

Series.str.pad(width, side='left', fillchar=' ')

  Pad strings in the Series/Index up to width.

  This function pads strings in a Series or Index to a specified width, filling the extra space with a character of your choice. It provides flexibility in positioning the padding, allowing it to be added to the left, right, or both sides. This is useful for formatting strings to align text or ensure consistent string lengths in data processing.

  Parameters:
    width int

      Minimum width of resulting string; additional characters will be filled with character defined in fillchar.

    side{‘left’, ‘right’, ‘both’}, default ‘left’

      Side from which to fill resulting string.

    fillchar str, default ‘ ‘

      Additional character for filling, default is whitespace.

  Returns:
    Series or Index of object

      Returns Series or Index with minimum number of char in object.

  See also

  `Series.str.rjust`

    Fills the left side of strings with an arbitrary character. Equivalent to `Series.str.pad(side='left')`.

  `Series.str.ljust`

    Fills the right side of strings with an arbitrary character. Equivalent to `Series.str.pad(side='right')`.

  `Series.str.center`

    Fills both sides of strings with an arbitrary character. Equivalent to `Series.str.pad(side='both')`.

  `Series.str.zfill`

    Pad strings in the Series/Index by prepending ‘0’ character. Equivalent to `Series.str.pad(side='left', fillchar='0')`.

  Examples

      >>> s = pd.Series(["caribou", "tiger"])
      >>> s
      0    caribou
      1      tiger
      dtype: str

      >>> s.str.pad(width=10)
      0       caribou
      1         tiger
      dtype: str

      >>> s.str.pad(width=10, side="right", fillchar="-")
      0    caribou---
      1    tiger-----
      dtype: str

      >>> s.str.pad(width=10, side="both", fillchar="-")
      0    -caribou--
      1    --tiger---
      dtype: str