numpy.strings.ljust — NumPy v2.6.dev0 Manual

strings.ljust(a, width, fillchar='')

[source]

#

Return an array with the elements of a left-justified in a string of length width.

Parameters:aarray-like, with StringDType, bytes_, or str_ dtypewidtharray_like, with any integer dtypeThe length of the resulting strings, unless width<str_len(a).

fillchararray-like, with StringDType, bytes_, or str_ dtypeOptional character to use for padding (default is space).

Returns:outndarrayOutput array of StringDType, bytes_ or str_ dtype, depending on input types

Notes

While it is possible for a and fillchar to have different dtypes, passing a non-ASCII character in fillchar when a is of dtype “S” is not allowed, and a ValueError is raised.

Examples

>>> importnumpyasnp>>> c=np.array(['aAaAaA',' aA ','abBABba'])>>> np.strings.ljust(c,width=3)array(['aAaAaA', ' aA ', 'abBABba'], dtype='<U7')>>> np.strings.ljust(c,width=9)array(['aAaAaA ', ' aA ', 'abBABba '], dtype='<U9')