numpy.strings.ljust#

strings.ljust(a, width, fillchar=' ')[source]#

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

Calls str.ljust element-wise.

Parameters:
aarray-like, with StringDType, bytes_, or str_ dtype
widtharray_like, with any integer dtype

The length of the resulting strings, unless width < str_len(a).

fillchararray-like, with StringDType, bytes_, or str_ dtype

Optional character to use for padding (default is space).

Returns:
outndarray

Output array of StringDType, bytes_ or str_ dtype, depending on input types

See also

str.ljust

Examples

>>> c = np.array(['aAaAaA', '  aA  ', 'abBABba'])
>>> np.strings.ljust(c, width=3)
array(['aAa', '  a', 'abB'], dtype='<U3')