hipdf.core.column.string.StringMethods.zfill

21 min read time

Applies to Linux

StringMethods.zfill(width: int) → SeriesOrIndex

Pad strings in the Series/Index by prepending ‘0’ characters.

Strings in the Series/Index are padded with ‘0’ characters on the left of the string to reach a total string length width. Strings in the Series/Index with length greater or equal to width are unchanged.

The sign character is preserved if it appears in the first position of the string.

Parameters

widthint

Minimum length of resulting string; strings with length less than width be prepended with ‘0’ characters.

Returns

Series/Index of str dtype

Returns Series or Index with prepended ‘0’ characters.

See Also

rjust

Fills the left side of strings with an arbitrary character.

ljust

Fills the right side of strings with an arbitrary character.

pad

Fills the specified sides of strings with an arbitrary character.

center

Fills both sides of strings with an arbitrary character.

Examples

>>> import cudf
>>> s = cudf.Series(['-1', '1', '1000',  None])
>>> s
0      -1
1       1
2    1000
3    <NA>
dtype: object

Note that None is not string, therefore it is converted to None. 1000 remains unchanged as it is longer than width.

>>> s.str.zfill(3)
0     -01
1     001
2    1000
3    <NA>
dtype: object