summaryrefslogtreecommitdiff
path: root/doc/string/ljust.rdoc
blob: 8e23c1fc8fef16f0f71c72c61d360fdf039994ab (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
Returns a left-justified copy of +self+.

If integer argument +size+ is greater than the size (in characters) of +self+,
returns a new string of length +size+ that is a copy of +self+,
left justified and padded on the right with +pad_string+:

  'hello'.ljust(10)       # => "hello     "
  '  hello'.ljust(10)     # => "  hello   "
  'hello'.ljust(10, 'ab') # => "helloababa"
  'тест'.ljust(10)        # => "тест      "
  'こんにちは'.ljust(10)    # => "こんにちは     "

If +size+ is not greater than the size of +self+, returns a copy of +self+:

  'hello'.ljust(5)  # => "hello"
  'hello'.ljust(1)  # => "hello"