Preview Ruby 4.1 is a preview. It can change before the final release. Switch to Ruby 4.0 →
instance method
String#ljust
(::int size, ?::string pad_string) -> ::String
ljust(width, pad_string = ' ') → new_string
string.c
View on GitHub ↗
static VALUE
rb_str_ljust(int argc, VALUE *argv, VALUE str)
{
return rb_str_justify(argc, argv, str, 'l');
}
Returns a copy of self, left-justified and, if necessary, right-padded with the pad_string:
Example
'hello'.ljust(10) # => "hello " ' hello'.ljust(10) # => " hello " 'hello'.ljust(10, 'ab') # => "helloababa" 'こんにちは'.ljust(10) # => "こんにちは "
If width <= self.length, returns a copy of self:
Example
'hello'.ljust(5) # => "hello" 'hello'.ljust(1) # => "hello" # Does not truncate to width.
Related: see Converting to New String.
Ruby version changes
-
3.0
-
The following methods now return or yield
Stringinstances instead of subclass instances when called on subclass instances: [Bug #10845]
-