summaryrefslogtreecommitdiff
path: root/doc/string/ljust.rdoc
blob: f37c0b3151176d243389372ca5c98374eb022ae2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
Returns a copy of +self+, left-justified and, if necessary, right-padded with the +pad_string+:

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

If <tt>width <= self.length</tt>, returns a copy of +self+:

  'hello'.ljust(5)  # => "hello"
  'hello'.ljust(1)  # => "hello"  # Does not truncate to width.

Related: see {Converting to New String}[rdoc-ref:String@Converting+to+New+String].