Ruby
Template:About Template:Distinguish Template:Infobox programming language
Ruby is a dynamic, interpreted, reflective, object-oriented, general-purpose programming language. It was designed and developed in the mid-1990s by Yukihiro "Matz" Matsumoto in Japan.
According to the creator, Ruby was influenced by Perl, Smalltalk, Eiffel, Ada, and Lisp.[1] It supports multiple programming paradigms, including functional, object-oriented, and imperative. It also has a dynamic type system and automatic memory management.
History
Early concept
Matsumoto has said that Ruby was conceived in 1993. In a 1999 post to the ruby-talk mailing list, he describes some of his early ideas about the language:[2]
Matsumoto describes the design of Ruby as being like a simple Lisp language at its core, with an object system like that of Smalltalk, blocks inspired by higher-order functions, and practical utility like that of Perl.[3]
The name "Ruby"
The name "Ruby" originated during an online chat session between Matsumoto and Keiju Ishitsuka on February 24, 1993, before any code had been written for the language.[4] Initially two names were proposed: "Coral" and "Ruby". Matsumoto chose the latter in a later e-mail to Ishitsuka.[5] Matsumoto later noted a factor in choosing the name "Ruby" – it was the birthstone of one of his colleagues.[6][7]
First publication
The first public release of Ruby 0.95 was announced on Japanese domestic newsgroups on December 21, 1995.[8][9] Subsequently, three more versions of Ruby were released in two days.[4] The release coincided with the launch of the Japanese-language ruby-list mailing list, which was the first mailing list for the new language.
Already present at this stage of development were many of the features familiar in later releases of Ruby, including object-oriented design, classes with inheritance, mixins, iterators, closures, exception handling and garbage collection.[10]
Early releases
Following the release of Ruby 0.95 in 1995, several stable versions of Ruby were released in the following years:
- Ruby 1.0: December 25, 1996[4]
- Ruby 1.2: December 1998
- Ruby 1.4: August 1999
- Ruby 1.6: September 2000
In 1997, the first article about Ruby was published on the Web. In the same year, Matsumoto was hired by netlab.jp to work on Ruby as a full-time developer.[4]
In 1998, the Ruby Application Archive was launched by Matsumoto, along with a simple English-language homepage for Ruby.[4]
In 1999, the first English language mailing list ruby-talk began, which signaled a growing interest in the language outside Japan.[11] In this same year, Matsumoto and Keiju Ishitsuka wrote the first book on Ruby, The Object-oriented Scripting Language Ruby (オブジェクト指向スクリプト言語 Ruby), which was published in Japan in October 1999. It would be followed in the early 2000s by around 20 books on Ruby published in Japanese.[4]
By 2000, Ruby was more popular than Python in Japan.[12] In September 2000, the first English language book Programming Ruby was printed, which was later freely released to the public, further widening the adoption of Ruby amongst English speakers. In early 2002, the English-language ruby-talk mailing list was receiving more messages than the Japanese-language ruby-list, demonstrating Ruby's increasing popularity in the non-Japanese speaking world.
Ruby 1.8
Ruby 1.8 was initially released August 2003, was stable for a long time, and was retired June 2013.[13] Although deprecated, there is still code based on it. Ruby 1.8 is only partially compatible with Ruby 1.9.
Ruby 1.8 has been the subject of several industry standards. The language specifications for Ruby were developed by the Open Standards Promotion Center of the Information-Technology Promotion Agency (a Japanese government agency) for submission to the Japanese Industrial Standards Committee (JISC) and then to the International Organization for Standardization (ISO). It was accepted as a Japanese Industrial Standard (JIS X 3017) in 2011[14] and an international standard (ISO/IEC 30170) in 2012.[15][16]
Around 2005, interest in the Ruby language surged in tandem with Ruby on Rails, a web framework written in Ruby. Rails is frequently credited with increasing awareness of Ruby.[17]
Ruby 1.9
Ruby 1.9 was released on Christmas Day in 2007. Effective with Ruby 1.9.3, released October 31, 2011,[18] Ruby switched from being dual-licensed under the Ruby License and the GPL to being dual-licensed under the Ruby License and the two-clause BSD license.[19] Adoption of 1.9 was slowed by changes from 1.8 that required many popular third party gems to be rewritten.
Ruby 1.9 introduces many significant changes over the 1.8 series.[20] Examples:
- block local variables (variables that are local to the block in which they are declared)
- an additional lambda syntax: Template:Code
- an additional Hash literal syntax using colons for symbol keys: Template:Code
- per-string character encodings are supported
- new socket API (IPv6 support)
require_relative
import security
Ruby 1.9 has been obsolete since February 23, 2015,[21] and it will no longer receive bug and security fixes. Users are advised to upgrade to a more recent version.
Ruby 2.0
Ruby 2.0 added several new features, including:
- method keyword arguments,
- a new method,
Module#prepend
, for extending a class, - a new literal for creating an array of symbols,
- new API for the lazy evaluation of Enumerables, and
- a new convention of using #to_h to convert objects to Hashes.[22]
Ruby 2.0 is intended to be fully backward compatible with Ruby 1.9.3. As of the official 2.0.0 release on February 24, 2013, there were only five known (minor) incompatibilities.[23]
It has been obsolete since February 22, 2016,[24] and it will no longer receive bug and security fixes. Users are advised to upgrade to a more recent version.
Ruby 2.1
Ruby 2.1.0 was released on Christmas Day in 2013.[25] The release includes speed-ups, bugfixes, and library updates.
Starting with 2.1.0, Ruby's versioning policy is more like semantic versioning.[26] Although similar, Ruby's versioning policy is not compatible with semantic versioning:
Ruby | Semantic versioning |
---|---|
MAJOR: Increased when incompatible change which can’t be released in MINOR. Reserved for special events. | MAJOR: Increased when you make incompatible API changes. |
MINOR: increased every Christmas, may be API incompatible. | MINOR: increased when you add functionality in a backwards-compatible manner. |
TEENY: security or bug fix which maintains API compatibility. May be increased more than 10 (such as 2.1.11), and will be released every 2–3 months. | PATCH: increased when you make backwards-compatible bug fixes. |
PATCH: number of commits since last MINOR release (will be reset at 0 when releasing MINOR). | - |
Semantic versioning also provides additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format, not available at Ruby.
Ruby 2.1 has been obsolete since April 1, 2017,[27] and it will no longer receive bug and security fixes. Users are advised to upgrade to a more recent version.
Ruby 2.2
Ruby 2.2.0 was released on Christmas Day in 2014.[28] The release includes speed-ups, bugfixes, and library updates and removes some deprecated APIs. Most notably, Ruby 2.2.0 introduces changes to memory handlingTemplate:Snd an incremental garbage collector, support for garbage collection of symbols and the option to compile directly against jemalloc. It also contains experimental support for using vfork(2) with system() and spawn(), and added support for the Unicode 7.0 specification.
Features that were made obsolete or removed include callcc, the DL library, Digest::HMAC, lib/rational.rb, lib/complex.rb, GServer, Logger::Application as well as various C API functions.[29]
- PowerPC64 performance
- Since version 2.2.1,[30] Ruby MRI performance on PowerPC64 was improved.[31][32][33]
Ruby 2.3
Ruby 2.3.0 was released on Christmas Day in 2015. A few notable changes include:
- The ability to mark all string literals as frozen by default with a consequently large performance increase in string operations.[34]
- Hash comparison to allow direct checking of key/value pairs instead of just keys.
- A new safe navigation operator
&.
that can ease nil handling (e.g. instead of Template:Code, we can useif obj&.foo&.bar
). - The did_you_mean gem is now bundled by default and required on startup to automatically suggest similar name matches on a NameError or NoMethodError.
- Hash#dig and Array#dig to easily extract deeply nested values (e.g. given Template:Code, the value Foo Baz can now be retrieved by
profile.dig(:social, :wikipedia, :name)
). .grep_v(regexp)
which will match all negative examples of a given regular expression in addition to other new features.
The 2.3 branch also includes many performance improvements, updates, and bugfixes including changes to Proc#call, Socket and IO use of exception keywords, Thread#name handling, default passive Net::FTP connections, and Rake being removed from stdlib.[35]
Ruby 2.4
Ruby 2.4.0 was released on Christmas Day in 2016. A few notable changes include:
- Binding#irb: Start a REPL session similar to binding.pry
- Unify Fixnum and Bignum into Integer class
- String supports Unicode case mappings, not just ASCII
- A new method, Regexp#match?, which is a faster boolean version of Regexp#match
- Thread deadlock detection now shows threads with their backtrace and dependency
The 2.4 branch also includes performance improvements to hash table, Array#max, Array#min, and instance variable access.[36]
Ruby's popularity has been declining since 2014,[37] a slip that may be permanent in the face of increasing competition.[38]
Ruby 2.5
Ruby 2.5.0 was released on Christmas Day in 2017.[39] A few notable changes include:
- rescue and ensure statements automatically use a surrounding do-end block (less need for extra begin-end blocks)
- Method-chaining with yield_self
- Support branch coverage and method coverage measurement
- Easier Hash transformations with Hash#slice and Hash#transform_keys
On top of that come a lot of performance improvements like faster block passing (3 times faster), faster Mutexes, faster ERB templates and improvements on some concatenation methods.
Table of versions
Version | Latest teeny version | Initial release date | End of support phase | End of security maintenance phase |
---|---|---|---|---|
Template:Version | NA | 1996-12-25[40] | NA | NA |
Template:Version | 1.8.7-p375[41] | 2003-08-04[42] | 2012-06[43] | 2014-07-01[44] |
Template:Version | 1.9.3-p551[45] | 2007-12-25[46] | 2014-02-23[47] | 2015-02-23[48] |
Template:Version | 2.0.0-p648[49] | 2013-02-24[50] | 2015-02-24[49] | 2016-02-24[49] |
Template:Version | 2.1.10[51] | 2013-12-25[52] | 2016-03-30[53][54] | 2017-03-31[55][56] |
Template:Version | 2.2.10[57] | 2014-12-25[58] | 2017-03-28[59] | 2018-03-31[60] |
Template:Version | 2.3.8[61] | 2015-12-25[62] | 2018-06-20[63] | 2019-03-31[63] |
Template:Version | 2.4.5[64] | 2016-12-25[65] | Template:TBA | Template:TBA |
Template:Version | 2.5.3[66] | 2017-12-25[67] | Template:TBA | Template:TBA |
Template:Version | 2018-12-25[68] | Template:TBA | Template:TBA | |
Template:Version | 2020[69][70] | Template:TBA | Template:TBA | |
Template:Version |
Philosophy
Matsumoto has said that Ruby is designed for programmer productivity and fun, following the principles of good user interface design.[71] At a Google Tech Talk in 2008 Matsumoto further stated, "I hope to see Ruby help every programmer in the world to be productive, and to enjoy programming, and to be happy. That is the primary purpose of Ruby language."[72] He stresses that systems design needs to emphasize human, rather than computer, needs:[73]
Ruby is said to follow the principle of least astonishment (POLA), meaning that the language should behave in such a way as to minimize confusion for experienced users. Matsumoto has said his primary design goal was to make a language that he himself enjoyed using, by minimizing programmer work and possible confusion. He has said that he had not applied the principle of least astonishment to the design of Ruby,[73] but nevertheless the phrase has come to be closely associated with the Ruby programming language. The phrase has itself been a source of surprise, as novice users may take it to mean that Ruby's behaviors try to closely match behaviors familiar from other languages. In a May 2005 discussion on the newsgroup comp.lang.ruby, Matsumoto attempted to distance Ruby from POLA, explaining that because any design choice will be surprising to someone, he uses a personal standard in evaluating surprise. If that personal standard remains consistent, there would be few surprises for those familiar with the standard.[74]
Matsumoto defined it this way in an interview:[73]
Features
- Thoroughly object-oriented with inheritance, mixins and metaclasses[75]
- Dynamic typing and duck typing
- Everything is an expression (even statements) and everything is executed imperatively (even declarations)
- Succinct and flexible syntax[76] that minimizes syntactic noise and serves as a foundation for domain-specific languages[77]
- Dynamic reflection and alteration of objects to facilitate metaprogramming[78]
- Lexical closures, iterators and generators, with a block syntax[79]
- Literal notation for arrays, hashes, regular expressions and symbols
- Embedding code in strings (interpolation)
- Default arguments
- Four levels of variable scope (global, class, instance, and local) denoted by sigils or the lack thereof
- Garbage collection
- First-class continuations
- Strict boolean coercion rules (everything is true except
false
andnil
) - Exception handling
- Operator overloading
- Built-in support for rational numbers, complex numbers and arbitrary-precision arithmetic
- Custom dispatch behavior (through
method_missing
andconst_missing
) - Native threads and cooperative fibers (fibers are a 1.9/YARV feature)
- Initial support for Unicode and multiple character encodings (no ICU support)[80]
- Native plug-in API in C
- Interactive Ruby Shell (a REPL)
- Centralized package management through RubyGems
- Implemented on all major platforms
- Large standard library, including modules for YAML, JSON, XML, CGI, OpenSSL, HTTP, FTP, RSS, curses, zlib and Tk[81]
Semantics
Ruby is object-oriented: every value is an object, including classes and instances of types that many other languages designate as primitives (such as integers, booleans, and "null"). Variables always hold references to objects. Every function is a method and methods are always called on an object. Methods defined at the top level scope become methods of the Object class. Since this class is an ancestor of every other class, such methods can be called on any object. They are also visible in all scopes, effectively serving as "global" procedures. Ruby supports inheritance with dynamic dispatch, mixins and singleton methods (belonging to, and defined for, a single instance rather than being defined on the class). Though Ruby does not support multiple inheritance, classes can import modules as mixins.
Ruby has been described as a multi-paradigm programming language: it allows procedural programming (defining functions/variables outside classes makes them part of the root, 'self' Object), with object orientation (everything is an object) or functional programming (it has anonymous functions, closures, and continuations; statements all have values, and functions return the last evaluation). It has support for introspection, reflection and metaprogramming, as well as support for interpreter-based[82] threads. Ruby features dynamic typing, and supports parametric polymorphism.
According to the Ruby FAQ, the syntax is similar to Perl and the semantics are similar to Smalltalk, but it differs greatly from Python.[83]
Syntax
The syntax of Ruby is broadly similar to that of Perl and Python. Class and method definitions are signaled by keywords, whereas code blocks can be both defined by 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.[84][85] 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 tradeoff 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.
See the Examples section below for samples of code demonstrating Ruby syntax.
Interaction
The Ruby official distribution also includes irb
, an interactive command-line interpreter that can be used to test code quickly. The following code fragment represents a sample session using irb
:
<source lang="irb"> $ irb irb(main):001:0> puts 'Hello, World' Hello, World
=> nil
irb(main):002:0> 1+2
=> 3
</source>
Examples
Template:Unreferenced section
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:
<source lang="ruby"> puts 'Hello World!' </source>
Some basic Ruby code:
<source lang="ruby">
- Everything, including a literal, is an object, so this works:
-199.abs # => 199 'ice is nice'.length # => 11 'ruby is cool.'.index('u') # => 1 "Nice Day Isn't It?".downcase.split().uniq.sort.join
- => " '?acdeinsty"
</source>
Input: <source lang="ruby"> print 'Please type name >' name = gets.chomp puts "Hello #{name}." </source> Conversions:
<source lang="ruby"> puts 'Give me a number' number = gets.chomp puts number.to_i output_number = number.to_i + 1 puts output_number.to_s + ' is a bigger number.' </source>
Strings
There are a variety of ways to define strings in Ruby.
The following assignments are equivalent:
<source lang="ruby"> a = "\nThis is a double-quoted string\n" a = %Q{\nThis is a double-quoted string\n} a = %{\nThis is a double-quoted string\n} a = %/\nThis is a double-quoted string\n/ a = <<-BLOCK
This is a double-quoted string BLOCK </source>
Strings support variable interpolation:
<source lang="ruby"> var = 3.14159 "pi is #{var}" => "pi is 3.14159" </source>
The following assignments are equivalent and produce raw strings:
<source lang="ruby"> a = 'This is a single-quoted string' a = %q{This is a single-quoted string} </source>
Collections
Constructing and using an array:
<source lang="ruby"> a = [1, 'hi', 3.14, 1, 2, [4, 5]]
a[2] # => 3.14 a.[](2) # => 3.14 a.reverse # => [[4, 5], 2, 1, 3.14, 'hi', 1] a.flatten.uniq # => [1, 'hi', 3.14, 2, 4, 5] </source>
Constructing and using an associative array (in Ruby, called a hash):
<source lang="ruby"> hash = Hash.new # equivalent to hash = {} hash = { :water => 'wet', :fire => 'hot' } # makes the previous line redundant as we are now
# assigning hash to a new, separate hash object
puts hash[:fire] # prints "hot"
hash.each_pair do |key, value| # or: hash.each do |key, value|
puts "#{key} is #{value}"
end
- returns {:water=>"wet", :fire=>"hot"} and prints:
- water is wet
- fire is hot
hash.delete :water # deletes the pair :water => 'wet' and returns "wet" hash.delete_if {|key,value| value == 'hot'} # deletes the pair :fire => 'hot' and returns {} </source>
Control structures
If statement:
<source lang="ruby">
- Generate a random number and print whether it's even or odd.
if rand(100).even?
puts "It's even"
else
puts "It's odd"
end </source>
Blocks and iterators
The two syntaxes for creating a code block:
<source lang="ruby"> { puts 'Hello, World!' } # note the braces
- or:
do
puts 'Hello, World!'
end </source>
A code block can be passed to a method as an optional block argument. Many built-in methods have such arguments:
<source lang="ruby"> File.open('file.txt', 'w') do |file| # 'w' denotes "write mode"
file.puts 'Wrote some text.'
end # file is automatically closed here
File.readlines('file.txt').each do |line|
puts line
end
- => Wrote some text.
</source>
Parameter-passing a block to be a closure:
<source lang="ruby">
- In an object instance variable (denoted with '@'), remember a block.
def remember(&a_block)
@block = a_block
end
- Invoke the preceding method, giving it a block that takes a name.
remember {|name| puts "Hello, #{name}!"}
- Call the closure (note that this happens not to close over any free variables):
@block.call('Jon') # => "Hello, Jon!" </source>
Creating an anonymous function:
<source lang="ruby"> proc {|arg| puts arg} Proc.new {|arg| puts arg} lambda {|arg| puts arg} ->(arg) {puts arg} # introduced in Ruby 1.9 </source>
Returning closures from a method:
<source lang="ruby"> def create_set_and_get(initial_value=0) # note the default value of 0
closure_value = initial_value [ Proc.new {|x| closure_value = x}, Proc.new { closure_value } ]
end
setter, getter = create_set_and_get # returns two values setter.call(21) getter.call # => 21
- Parameter variables can also be used as a binding for the closure,
- so the preceding can be rewritten as:
def create_set_and_get(closure_value=0)
[ proc {|x| closure_value = x } , proc { closure_value } ]
end </source>
Yielding the flow of program control to a block that was provided at calling time:
<source lang="ruby"> def use_hello
yield "hello"
end
- Invoke the preceding method, passing it a block.
use_hello {|string| puts string} # => 'hello' </source>
Iterating over enumerations and arrays using blocks:
<source lang="ruby"> array = [1, 'hi', 3.14] array.each {|item| puts item }
- prints:
- 1
- 'hi'
- 3.14
array.each_index {|index| puts "#{index}: #{array[index]}" }
- prints:
- 0: 1
- 1: 'hi'
- 2: 3.14
- The following uses a (a..b) Range
(3..6).each {|num| puts num }
- prints:
- 3
- 4
- 5
- 6
- The following uses a (a...b) Range
(3...6).each {|num| puts num }
- prints:
- 3
- 4
- 5
</source>
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:
<source lang="ruby"> [1,3,5].inject(10) {|sum, element| sum + element} # => 19 </source>
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):
<source lang="ruby"> (1..10).collect {|x| x*x} # => [1, 4, 9, 16, 25, 36, 49, 64, 81, 100] </source>
Or invoke a method on each item (map
is a synonym for collect
):
<source lang="ruby"> (1..5).map(&:to_f) # => [1.0, 2.0, 3.0, 4.0, 5.0] </source>
Classes
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.
<source lang="ruby"> class Person
attr_reader :name, :age def initialize(name, age) @name, @age = name, age end def <=>(person) # the comparison operator for sorting @age <=> person.age end def to_s "#{@name} (#{@age})" end
end
group = [
Person.new("Bob", 33), Person.new("Chris", 16), Person.new("Ash", 23)
]
puts group.sort.reverse </source>
The preceding code prints three names in reverse age order:
<source lang="text"> Bob (33) Ash (23) Chris (16) </source>
Person
is a constant and is a reference to a Class
object.
Open classes
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:
<source lang="ruby">
- re-open Ruby's Time class
class Time
def yesterday self - 86400 end
end
today = Time.now # => 2013-09-03 16:09:37 +0300 yesterday = today.yesterday # => 2013-09-02 16:09:37 +0300 </source>
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.
<source lang="ruby">
- re-open Ruby's Time class
module RelativeTimeExtensions
refine Time do def half_a_day_ago self - 43200 end end
end
module MyModule
class MyClass # Allow the refinement to be used using RelativeTimeExtensions
def window Time.now.half_a_day_ago end end
end </source>
Exceptions
An exception is raised with a raise
call:
<source lang="ruby"> raise </source>
An optional message can be added to the exception:
<source lang="ruby"> raise "This is a message" </source>
Exceptions can also be specified by the programmer:
<source lang="ruby"> raise ArgumentError, "Illegal arguments!" </source>
Alternatively, an exception instance can be passed to the raise
method:
<source lang="ruby"> raise ArgumentError.new("Illegal arguments!") </source>
This last construct is useful when raising an instance of a custom exception class featuring a constructor that takes more than one argument:
<source lang="ruby"> class ParseError < Exception
def initialize(input, line, pos) super "Could not parse '#{input}' at line #{line}, position #{pos}" end
end
raise ParseError.new("Foo", 3, 9) </source>
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
:
<source lang="ruby"> begin
# do something
rescue
# handle exception
else
# do this if no exception was raised
ensure
# do this whether or not an exception was raised
end </source>
It is a common mistake to attempt to catch all exceptions with a simple rescue clause. To catch all exceptions one must write:
<source lang="ruby"> begin
# do something
rescue Exception
# Exception handling code here. # Don't write only "rescue"; that only catches StandardError, a subclass of Exception.
end </source>
Or catch particular exceptions:
<source lang="ruby"> begin
# do something
rescue RuntimeError
# handle only RuntimeError and its subclasses
end </source>
It is also possible to specify that the exception object be made available to the handler clause:
<source lang="ruby"> begin
# do something
rescue RuntimeError => e
# handling, possibly involving e, such as "puts e.to_s"
end </source>
Alternatively, the most recent exception is stored in the magic global $!
.
Several exceptions can also be caught:
<source lang="ruby"> begin
# do something
rescue RuntimeError, Timeout::Error => e
# handling, possibly involving e
end </source>
Metaprogramming
Template:Refimprove section 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.
<source lang="ruby"> COLORS = { black: "000",
red: "f00", green: "0f0", yellow: "ff0", blue: "00f", magenta: "f0f", cyan: "0ff", white: "fff" }
class String
COLORS.each do |color,code|
define_method "in_#{color}" do
"#{self}"
end
end
end </source>
The generated methods could then be used like this:
<source lang="ruby"> "Hello, World!".in_blue
=> "Hello, World!"
</source>
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:
- intercepting and modifying method calls
- implementing new inheritance models
- dynamically generating classes from parameters
- automatic object serialization
- interactive help and debugging
More examples
More sample Ruby code is available as algorithms in the following article:
Implementations
Matz's Ruby interpreter
The original Ruby interpreter is often referred to as the Matz's Ruby Interpreter or MRI. This implementation is written in C and uses its own Ruby-specific virtual machine.
The standardized and retired Ruby 1.8 implementation was written in C, as a single-pass interpreted language.[13]
Starting with Ruby 1.9, and continuing with Ruby 2.x and above, the official Ruby interpreter has been YARV ("Yet Another Ruby VM"), and this implementation has superseded the slower virtual machine used in previous releases of MRI.
Alternate implementations
Template:As of, there are a number of alternative implementations of Ruby, including JRuby, Rubinius, and mruby. Each takes a different approach, with JRuby and Rubinius providing just-in-time compilation and mruby also providing ahead-of-time compilation.
Ruby has three major alternate implementations:
- JRuby, a Java implementation that runs on the Java virtual machine. JRuby currently targets Ruby 2.3.
- TruffleRuby, a Java implementation using the Truffle language implementation framework with GraalVM
- Rubinius, a C++ bytecode virtual machine that uses LLVM to compile to machine code at runtime. The bytecode compiler and most core classes are written in pure Ruby. Rubinius currently targets Ruby 2.1,
Other Ruby implementations include:
- MagLev, a Smalltalk implementation that runs on GemTalk Systems' GemStone/S VM
- mruby, an implementation designed to be embedded into C code, in a similar vein to Lua. It is currently being developed by Yukihiro Matsumoto and others
- RGSS, or Ruby Game Scripting System, a proprietary implementation that is used by the RPG Maker series of software for game design and modification of the RPG Maker engine
- A transpiler (partial) from Ruby to Julia, julializer is available. It can be used for a large speedup over e.g. Ruby or JRuby implementations (may only be useful for numerical code).[86]
- Topaz, a Ruby implementation written in Python
- Opal, a web-based interpreter that compiles Ruby to JavaScript
Other now defunct Ruby implementations were:
- MacRuby, a Mac OS X implementation on the Objective-C runtime. Its iOS counterpart is called RubyMotion
- IronRuby an implementation on the .NET Framework
- Cardinal, an implementation for the Parrot virtual machine
- Ruby Enterprise Edition, often shortened to ree, an implementation optimized to handle large-scale Ruby on Rails projects
- HotRuby, a JavaScript and ActionScript implementation of the Ruby programming language
The maturity of Ruby implementations tends to be measured by their ability to run the Ruby on Rails (Rails) framework, because it is complex to implement and uses many Ruby-specific features. The point when a particular implementation achieves this goal is called "the Rails singularity". The reference implementation (MRI), JRuby, and Rubinius[87] are all able to run Rails unmodified in a production environment.
Platform support
Matsumoto originally did Ruby development on the 4.3BSD-based Sony NEWS-OS 3.x, but later migrated his work to SunOS 4.x, and finally to Linux.[88][89]
By 1999, Ruby was known to work across many different operating systems, including NEWS-OS, SunOS, AIX, SVR4, Solaris, NEC UP-UX, NeXTSTEP, BSD, Linux, Mac OS, DOS, Windows, and BeOS.[90]
Modern Ruby versions and implementations are available on many operating systems, such as Linux, BSD, Solaris, AIX, macOS, Windows, Windows Phone,[91] Windows CE, Symbian OS, BeOS, and IBM i.
Repositories and libraries
RubyGems is Ruby's package manager. A Ruby package is called a "gem" and can easily be installed via the command line. Most gems are libraries, though a few exist that are applications, such as IDEs.[92] There are over 9,000 Ruby gems hosted on RubyGems.org.
Many new and existing Ruby libraries are hosted on GitHub, a service that offers version control repository hosting for Git.
The Ruby Application Archive, which hosted applications, documentation, and libraries for Ruby programming, was maintained until 2013, when its function was transferred to RubyGems.[93]
See also
- Comparison of programming languages
- Metasploit ProjectTemplate:Snd the world's largest Ruby project, with over 700,000 lines of code
- Why's (poignant) Guide to RubyTemplate:Snd an online Ruby textbook in graphic novel format
- XRubyTemplate:Snd a Ruby to Java static compiler
- CrystalTemplate:Snd a programming language inspired by Ruby
References
| references-column-width | references-column-count references-column-count-{{#if:1|30em}} }} | {{#if: | references-column-width }} }}" style="{{#if: 30em | {{#iferror: {{#ifexpr: 30em > 1 }} | Template:Column-width | Template:Column-count }} | {{#if: | Template:Column-width }} }} list-style-type: {{#switch: | upper-alpha | upper-roman | lower-alpha | lower-greek | lower-roman = {{{group}}} | #default = decimal}};">
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Citation
- ↑ 4.0 4.1 4.2 4.3 4.4 4.5 Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite mailing list
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ 13.0 13.1 Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Web Development: Ruby on Rails. Devarticles.com (2007-03-22). Retrieved on 2013-07-17.
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Ruby 1.9: What to Expect. Slideshow.rubyforge.org. Retrieved on 2013-07-17.
- ↑ Template:Cite web
- ↑ Endoh, Yusuke. (2013-02-24) Ruby 2.0.0-p0 is released. Ruby-lang.org. Retrieved on 2013-07-17.
- ↑ Endoh, Yusuke. (2013-02-24) Ruby 2.0.0-p0 is released. Ruby-lang.org. Retrieved on 2013-07-17.
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ 49.0 49.1 49.2 Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ 63.0 63.1 Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Cite error: Invalid
<ref>
tag; no text was provided for refs namedruby-253-announce
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:YouTube
- ↑ 73.0 73.1 73.2 Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Green threads
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
- ↑ Template:Cite web
Further reading
- Template:Citation
- Template:Citation
- Template:Citation
- Template:Citation
- Template:Citation
- Template:Citation
- Template:Citation
- Template:Citation
- Template:Citation
- Template:Citation
External links
Template:Wikiquote Template:Commons category Template:Wikibooks Template:Wikiversity
- Template:Official website
- Official Ruby documentation
- Ruby User GuideTemplate:Snd by Yukihiro Matsumoto, the creator of Ruby
- A community-driven Ruby coding style guide
- Ruby From Other Languages
- Ruby ForumTemplate:Snd gateway to the ruby-talk mailing list
- Try Ruby!Template:Snd web-based Ruby REPL
- Ruby Draft Specification, September 2010
- Template:Dmoz
Template:Ruby programming language Template:Programming languages Template:FOSS Template:ISO standards Template:Authority control
- Pages with reference errors
- Pages with broken file links
- Ruby (programming language)
- Articles with example Ruby code
- Class-based programming languages
- Dynamic programming languages
- Dynamically typed programming languages
- Free software programmed in C
- ISO standards
- Object-oriented programming languages
- Programming languages created in 1995
- Programming languages with an ISO standard
- Scripting languages
- Software using the BSD license
- Text-oriented programming languages
- Free compilers and interpreters