cudf.core.column.string.StringMethods.zfill#
- 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.
- 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
Notes
Differs from str.zfill() which has special handling for ‘+’/’-‘ in the string.
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 toNone
. The minus sign in'-1'
is treated as a regular character and the zero is added to the left of it (str.zfill() would have moved it to the left).1000
remains unchanged as it is longer than width.>>> s.str.zfill(3) 0 0-1 1 001 2 1000 3 <NA> dtype: object