Requires the Hack Standard Library to be installed.
Facebook Engineer?

This function is available as Str\pad_left() in Facebook's www repository.

Returns the string padded to the total length by appending the $pad_string to the left

namespace HH\Lib\Str;

function pad_left(
  string $string,
  int $total_length,
  string $pad_string = ' ',
): string;

If the length of the input string plus the pad string exceeds the total length, the pad string will be truncated. If the total length is less than or equal to the length of the input string, no padding will occur.

To pad the string on the right, see Str\pad_right().


  • string $string
  • int $total_length
  • string $pad_string = ' '


  • string