Skip to main content
`Ctrl`+`K`

# numpy.strings.ljust

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

  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

  See also

  `str.ljust`

  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)
      array(['aAaAaA', '  aA  ', 'abBABba'], dtype='<U7')
      >>> np.strings.ljust(c, width=9)
      array(['aAaAaA   ', '  aA     ', 'abBABba  '], dtype='<U9')