The syntax of the Ruby programming language is broadly similar to that of Perl and Python. Class and method definitions are signaled by keywords, whereas code blocks can be defined by either keywords or braces. In contrast to Perl, variables are not obligatorily prefixed with a sigil. When used, the sigil changes the semantics of scope of the variable. For practical purposes there is no distinction between expressions and statements. Line breaks are significant and taken as the end of a statement; a semicolon may be equivalently used. Unlike Python, indentation is not significant.
One of the differences from Python and Perl is that Ruby keeps all of its instance variables completely private to the class and only exposes them through accessor methods (attr_writer, attr_reader, etc.). Unlike the "getter" and "setter" methods of other languages like C++ or Java, accessor methods in Ruby can be created with a single line of code via metaprogramming; however, accessor methods can also be created in the traditional fashion of C++ and Java. As invocation of these methods does not require the use of parentheses, it is trivial to change an instance variable into a full function without modifying a single line of calling code or having to do any refactoring achieving similar functionality to C# and VB.NET property members.
Python's property descriptors are similar, but come with a trade-off in the development process. If one begins in Python by using a publicly exposed instance variable, and later changes the implementation to use a private instance variable exposed through a property descriptor, code internal to the class may need to be adjusted to use the private variable rather than the public property. Ruby's design forces all instance variables to be private, but also provides a simple way to declare set and get methods. This is in keeping with the idea that in Ruby one never directly accesses the internal members of a class from outside the class; rather, one passes a message to the class and receives a response.
The following examples can be run in a Ruby shell such as Interactive Ruby Shell, or saved in a file and run from the command line by typing ruby ''<filename>''.
Classic Hello world example:
Some basic Ruby code:
-199.abs # => 199'ice is nice'.length # => 11'ruby is cool.'.index('u') # => 1"Nice Day Isn't It?".downcase.split().uniq.sort.join
Input:
There are a variety of ways to define strings in Ruby.
The following assignments are equivalent:
This is a double-quoted stringBLOCK
Strings support variable interpolation:
The following assignments are equivalent and produce raw strings:
Constructing and using an array:
a[2] # => 14.5a.[](2) # => 14.5a.reverse # => 6, 15, 2, 1, 14.5, 'hello', 3]a.flatten.uniq # => [3, 'hello', 14.5, 1, 2, 6, 15]
Constructing and using an associative array (in Ruby, called a hash):
hash.each_pair do |key, value| # or: hash.each do |key, value| puts "# is #"end
hash.delete :water # deletes the pair :water => 'wet' and returns "wet"hash.delete_if
value 'hot' |
If statement:
if rand(100).even? puts "It's even"else puts "It's odd"end
The two syntaxes for creating a code block:
do puts 'Hello, World!'end
A code block can be passed to a method as an optional block argument. Many built-in methods have such arguments:
File.readlines('file.txt').each do |line| puts lineend
Parameter-passing a block to be a closure:
def remember(&a_block) @block = a_blockend
remember
| puts "Hello, #!" |
@block.call('Jon') # => "Hello, Jon!"
Creating an anonymous function:
| puts arg |
| puts arg |
| puts arg |
Returning closures from a method:
setter, getter = create_set_and_get # returns two valuessetter.call(21)getter.call # => 21
def create_set_and_get(closure_value=0) [proc {|x| closure_value = x }, proc { closure_value } ]end
Yielding the flow of program control to a block that was provided at calling time:
use_hello
| puts string |
Iterating over enumerations and arrays using blocks:
| puts item |
array.each_index
| puts "#: #" |
(3..6).each
| puts num |
(3...6).each
| puts num |
A method such as inject can accept both a parameter and a block. The inject method iterates over each member of a list, performing some function on it while retaining an aggregate. This is analogous to the [[foldl]] function in functional programming languages. For example:
| sum + element |
On the first pass, the block receives 10 (the argument to inject) as sum, and 1 (the first element of the array) as element. This returns 11, which then becomes sum on the next pass. It is added to 3 to get 14, which is then added to 5 on the third pass, to finally return 19.
Using an enumeration and a block to square the numbers 1 to 10 (using a range):
| x*x |
Or invoke a method on each item (map is a synonym for collect):
The following code defines a class named Person. In addition to initialize, the usual constructor to create new objects, it has two methods: one to override the <=> comparison operator (so Array#sort can sort by age) and the other to override the to_s method (so Kernel#puts can format its output). Here, attr_reader is an example of metaprogramming in Ruby: attr_accessor defines getter and setter methods of instance variables, but attr_reader only getter methods. The last evaluated statement in a method is its return value, allowing the omission of an explicit return statement.
group = [Person.new("Bob", 33), Person.new("Chris", 16), Person.new("Ash", 23) ]
puts group.sort.reverse
The preceding code prints three names in reverse age order:
Person is a constant and is a reference to a Class object.
In Ruby, classes are never closed: methods can always be added to an existing class. This applies to all classes, including the standard, built-in classes. All that is needed to do is open up a class definition for an existing class, and the new contents specified will be added to the existing contents. A simple example of adding a new method to the standard library's Time class:
class Time def yesterday self - 86400 endend
today = Time.now # => 2013-09-03 16:09:37 +0300yesterday = today.yesterday # => 2013-09-02 16:09:37 +0300
Adding methods to previously defined classes is often called monkey-patching. If performed recklessly, the practice can lead to both behavior collisions with subsequent unexpected results and code scalability problems.
Since Ruby 2.0 it has been possible to use refinements to reduce the potentially negative consequences of monkey-patching, by limiting the scope of the patch to particular areas of the code base.
module RelativeTimeExtensions refine Time do def half_a_day_ago self - 43200 end endend
module MyModule class MyClass # Allow the refinement to be used using RelativeTimeExtensions
def window Time.now.half_a_day_ago end endend
An exception is raised with a raise call:
An optional message can be added to the exception:
Exceptions can also be specified by the programmer:
Alternatively, an exception instance can be passed to the raise method:
This last construct is useful when raising an instance of a custom exception class featuring a constructor that takes more than one argument:
raise ParseError.new("Foo", 3, 9)
Exceptions are handled by the rescue clause. Such a clause can catch exceptions that inherit from StandardError. Other flow control keywords that can be used when handling exceptions are else and ensure:
It is a common mistake to attempt to catch all exceptions with a simple rescue clause. To catch all exceptions one must write:
Or catch particular exceptions:
It is also possible to specify that the exception object be made available to the handler clause:
Alternatively, the most recent exception is stored in the magic global $!.
Several exceptions can also be caught:
Ruby code can programmatically modify, at runtime, aspects of its own structure that would be fixed in more rigid languages, such as class and method definitions. This sort of metaprogramming can be used to write more concise code and effectively extend the language.
For example, the following Ruby code generates new methods for the built-in String class, based on a list of colors. The methods wrap the contents of the string with an HTML tag styled with the respective color.
class String COLORS.each do |color,code| define_method "in_#" do "
" end endendThe generated methods could then be used like this:
To implement the equivalent in many other languages, the programmer would have to write each method (in_black, in_red, in_green, etc.) separately.
Some other possible uses for Ruby metaprogramming include: