left_pad

Pad a string to the left with any number of characters.


License
MPL-2.0

Documentation

LeftPad

Pad a string to the left with any number of characters.

iex(1)> LeftPad.left_pad("foo", 5)
"  foo"
iex(2)> LeftPad.left_pad("foo", 6, "-")
"---foo"
iex(3)> LeftPad.left_pad("foo", 10, "/.-")
"/.-/.-/foo"
iex(4)> LeftPad.left_pad("foo", 6, "❤️")
"❤️❤️❤️foo"

Installation

LeftPad is available in Hex. The package can be installed by:

  1. Add left_pad to your list of dependencies in mix.exs:

    def deps do
      [{:left_pad, "~> 0.0.3"}]
    end
    
  2. Ensure left_pad is started before your application:

    def application do
      [applications: [:left_pad]]
    end
    

FAQ

Q: Isn't this just String.rjust?

A: No. String.rjust only accepts a single character to pad by. left_pad can pad with an entire string, repeating it if needed. It also supports Unicode.

Q: Will you unpublish this in the future, potentially breaking the builds of every library that depends on it?

A: ¯\_(ツ)_/¯

License

See LICENSE