pandas.Series.str.pad¶
- Series.str.pad(width, side='left', fillchar=' ')[source]¶
Pad strings in the Series/Index up to width.
- Parameters
- widthint
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.
- fillcharstr, 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: object
>>> s.str.pad(width=10) 0 caribou 1 tiger dtype: object
>>> s.str.pad(width=10, side='right', fillchar='-') 0 caribou--- 1 tiger----- dtype: object
>>> s.str.pad(width=10, side='both', fillchar='-') 0 -caribou-- 1 --tiger--- dtype: object