Ruby Method of the Day - String.<<

Kelly McCauley — Fri, 31 Aug 2007 00:01:00 -0500

Signature

string << other_string      #=> string
string.concat(other_string) #=> string
string << integer           #=> string  # integer must be between 0 and 255
string.concat(integer)      #=> string  # integer must be between 0 and 255

string.<< appends other_string or the ascii character equivalent of integer and returns itself.

Examples

x = 'foo'
x << 'bar'            #=> "foobar"
y = 'fred'
y.concat('bob')       #=> "fredbob"

# Since x.<< returns itself, multiple calls to << will append to the first
# string object.
x << 'baz' << 'foz'   #=> "foobarbazfoz"
y.concat('bill').concat('alice')    #=> "fredbobbillalice"

z = 'a'
z << 98 << 99         #=> "abc"
z.concat(100)         #=> "abcd"

begin
  a = ''
  a << 1000
rescue Exception => e
  e.inspect           #=> #<TypeError: can't convert Fixnum into String>
end

Say what???: Ruby Method of the Day - String.<<

Ruby Method of the Day - String.<<

Signature

Examples

Documentation Reference