Bang methods (ending with !) in Ruby

Introduction

Bang methods in Ruby are special versions of methods that usually change the object they are called on. They end with an exclamation mark (!).

When you want to change the original data instead of making a copy.

When you want to be clear that a method will modify the object directly.

When you want to avoid creating a new object and save memory.

When you want to signal that the method might be 'dangerous' or irreversible.

When you want to write cleaner and faster code by modifying in place.

Syntax

Ruby

object.method_name!

# Example:
array.sort!
string.upcase!

Bang methods usually modify the object itself (called 'in-place').

Not all methods have bang versions, but when they do, the bang version changes the object, the non-bang version returns a new object.

Examples

The sort method returns a new sorted array but does not change the original.

Ruby

array = [3, 1, 2]
array.sort
# => [1, 2, 3]
array # => [3, 1, 2]

The sort! method sorts the array in place, changing the original array.

Ruby

array = [3, 1, 2]
array.sort!
# => [1, 2, 3]
array # => [1, 2, 3]

upcase returns a new string in uppercase but does not change the original.

Ruby

string = "hello"
string.upcase
# => "HELLO"
string # => "hello"

upcase! changes the original string to uppercase.

Ruby

string = "hello"
string.upcase!
# => "HELLO"
string # => "HELLO"

Sample Program

This program shows the difference between sort and sort!. The first does not change the original array, the second does.

Ruby

array = [5, 3, 8, 1]
puts "Original array: #{array}"
sorted_array = array.sort
puts "After sort (non-bang): #{sorted_array}"
puts "Array after sort (non-bang): #{array}"

array.sort!
puts "Array after sort! (bang): #{array}"

Important Notes

Bang methods usually return nil if no changes were made.

Use bang methods carefully because they change your data directly.

Not all bang methods are dangerous; the exclamation mark is a Ruby convention to warn you.

Summary

Bang methods end with ! and usually change the object itself.

Non-bang methods return a new object and leave the original unchanged.

Use bang methods when you want to modify data directly and clearly.