geor-g / left_pad.ex

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

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