`numpy.strings:ljust`

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

Signature

def ljust ( a , width , fillchar = )

Summary

Return an array with the elements of a left-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 character to use for padding (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
c = np.array(['aAaAaA', '  aA  ', 'abBABba'])
np.strings.ljust(c, width=3)
np.strings.ljust(c, width=9)

✓

Aliases

numpy.char.ljust