numpy.strings.rjust#

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

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

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 padding character to use (default is space).

Returns:
outndarray

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

See also

str.rjust

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

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