This is a pre-release version (2.5.0.dev0+git20251130.2de293a). Go to latest (2.4.4)
{ } Raw JSON

bundles / numpy 2.5.0.dev0+git20251130.2de293a / numpy / strings / rjust

_ArrayFunctionDispatcher

numpy.strings:rjust

source: build-install/usr/lib/python3.14/site-packages/numpy/_core/strings.py :825

Signature

def   rjust ( a width fillchar = )

Summary

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

Parameters

a : array-like, with ``StringDType``, ``bytes_``, or ``str_`` dtype
width : array_like, with any integer dtype

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

fillchar : array-like, with ``StringDType``, ``bytes_``, or ``str_`` dtype

Optional padding character to use (default is space).

Returns

out : ndarray

Output 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

import numpy as np
a = np.array(['aAaAaA', '  aA  ', 'abBABba'])
np.strings.rjust(a, width=3)
np.strings.rjust(a, width=9)

See also

str.rjust

Aliases

  • numpy.char.rjust