Ruby Is A Pure Object Oriented Programming Language

Ruby is a pure object oriented programming language. It was created in 1993 by Yukihiro Matsumoto of Japan.
You can find the name Yukihiro Matsumoto on the Ruby mailing list at www.ruby-lang.org. Matsumoto is also known as Matz in the Ruby community. Ruby is "A Programmer's Best Friend". Ruby has features that are similar to those of Smalltalk, Perl, and Python. Perl, Python, and Smalltalk are scripting languages. Smalltalk is a true object-oriented language. Ruby, like Smalltalk, is a perfect objectoriented language. Using Ruby syntax is much easier than using Smalltalk syntax.
Features of Ruby:

Ruby is an open-source and is freely available on the Web, but it is subject to a license. Ruby is a general-purpose, interpreted programming language. Ruby is a true object-oriented programming language. Ruby is a server-side scripting language similar to Python and PERL. Ruby can be used to write Common Gateway Interface (CGI) scripts. Ruby can be embeded into Hypertext Markup Language (HTML). Ruby has a clean and easy syntax that allows a new developer to learn Ruby very quickly and easily. Ruby has similar syntax to that of many programming languages such as C++ and Perl. Ruby is very much scalable and big programs written in Ruby are easily maintainable. Ruby can be used for developing Internet and intranet applications. Ruby can be installed in Windows and POSIX environments. Ruby support many GUI tools such as Tcl/Tk, GTK, and OpenGL. Ruby can easily be connected to DB2, MySQL, Oracle, and Sybase. Ruby has a rich set of built-in functions which can be used directly into Ruby scripts.
Tools You Will Need:

For performing the examples discussed in this tutorial, you will need a Pentium 200-MHz computer with a minimum of 64 MB of RAM (128 MB of RAM recommended). You also will need the following software:
Linux 7.1 or Windows 95/98/2000/NT operating system Apache 1.3.19-5 Web server Internet Explorer 5.0 or above Web browser Ruby 1.6.6
This tutorial will provide the necessary skills to create GUI, networking, and Web applications using Ruby. It also will talk about extending and embedding Ruby applications.
Popular Ruby Editors:

To write your Ruby programs you will need an editor:
If you are working on Windows machine then you can use any simple text editor like Notepad or Edit plus. VIM (Vi IMproved) is very simple text editor. This is available on almost all Unix machines and now Windows as well. Otherwise your can use your favorite vi editor to write Ruby programs. RubyWin is a Ruby Integrated Development Environment (IDE) for Windows. Ruby Development Environment (RDE) is also very good IDE for windows users.
Interactive Ruby (IRb):

Interactive Ruby (IRb) provides a shell for experimentation. Within the IRb shell, you can immediately view expression results, line by line. This tool comes along with Ruby installation so you have nothing to do extra to have IRb working. Just type irb at your command prompt and an Interactive Ruby Session will start as given below:
$irb irb 0.6.1(99/09/16) irb(main):001:0> def hello irb(main):002:1> out = "Hello World" irb(main):003:1> puts out irb(main):004:1> end nil irb(main):005:0> hello Hello World nil irb(main):006:0>
Let us write a simple program in ruby. All ruby files will have extension .rb. So put the following source code in a test.rb file.
#!/usr/bin/ruby -w puts "Hello, Ruby!";

Here I assumed that you have ruby interpreter available in /usr/bin directory. Now try to run this program as follows:
$ ruby test.rb
This will produce following result:
Hello, Ruby!
You have seen a simple Ruby program, now lets see few basic concepts related to Ruby Syntax:
Whitespace in Ruby Program:

Whitespace characters such as spaces and tabs are generally ignored in Ruby code, except when they appear in strings. Sometimes, however, they are used to interpret ambiguous statements. Interpretations of this sort produce warnings when the -w option is enabled. Example:
a + b is interpreted as a+b ( Here a is a local variable) a +b is interpreted as a(+b) ( Here a is a method call)
Line Endings in Ruby Program:

Ruby interprets semicolons and newline characters as the ending of a statement. However, if Ruby encounters operators, such as +, -, or backslash at the end of a line, they indicate the continuation of a statement.
Ruby Identifiers:
Identifiers are names of variables, constants, and methods. Ruby identifiers are case sensitive. It mean Ram and RAM are two different itendifiers in Ruby. Ruby identifier names may consist of alphanumeric characters and the underscore character ( _ ).
Reserved Words:
The following list shows the reserved words in Ruby. These reserved words may not be used as constant or variable names. They can, however, be used as method names. BEGIN END alias and begin break case class def defined? do else elsif end ensure false for if in module next nill not or redo rescue retry return self super then true undef unless until when while while __FILE__ __LINE__
Here Document in Ruby:

"Here Document" refers to build strings from multiple lines. Following a << you can specify a string or an identifier to terminate the string literal, and all lines following the current line up to the terminator are the value of the string. If the terminator is quoted, the type of quotes determines the type of the line-oriented string literal. Notice there must be no space between << and the terminator.
Here are different examples:
#!/usr/bin/ruby -w print <<EOF This is the first way of creating here document ie. multiple line string. EOF print <<"EOF"; # same as above This is the second way of creating here document ie. multiple line string. EOF print <<ÈOC` echo hi there echo lo there EOC print <<"foo", <<"bar" I said foo. foo I said bar. bar # execute commands
# you can stack them
This is the first way of creating her document ie. multiple line string. This is the second way of creating her document ie. multiple line string. hi there lo there I said foo. I said bar.
Ruby BEGIN Statement

Syntax:
BEGIN { code }
Declares code to be called before the program is run.
Example:
#!/usr/bin/ruby puts "This is main Ruby Program" BEGIN { puts "Initializing Ruby Program" }
Initializing Ruby Program This is main Ruby Program
Ruby END Statement

Syntax:
END { code }
Declares code to be called at the end of the program.
Example:
#!/usr/bin/ruby puts "This is main Ruby Program" END { puts "Terminating Ruby Program" } BEGIN { puts "Initializing Ruby Program" }
Initializing Ruby Program This is main Ruby Program Terminating Ruby Program
Ruby Comments:
A comment hides a line, part of a line, or several lines from the Ruby interpreter. You can use the hash character (#) at the beginning of a line:
# I am a comment. Just ignore me.

Or, a comment may be on the same line after a statement or expression:
name = "Madisetti" # This is again comment

You can comment multiple lines as follows:
# # # #
This is a comment. This is a comment, too. This is a comment, too. I said that already.
Here is another form. This block comment conceals several lines from the interpreter with =begin/=end:
=begin This is a comment. This is a comment, too. This is a comment, too. I said that already. =end
Ruby is a perfect Object Oriented Programming Language. The features of the object-oriented programming language include:
Data Encapsulation: Data Abstraction: Polymorphism: Inheritance:
These features have been discussed in Object Oriented Ruby. An object-oriented program involves classes and objects. A class is the blueprint from which individual objects are created. In object-oriented terms, we say that your bicycle is an instance of the class of objects known as bicycles. Take the example of any vehicle. It comprises wheels, horsepower, and fuel or gas tank capacity. These characteristics form the data members of the class Vehicle. You can differentiate one vehicle from the other with the help of these characteristics. A vehicle can also have certain functions, such as halting, driving, and speeding. Even these functions form the data members of the class Vehicle. You can, therefore, define a class as a combination of characteristics and functions. A class Vehicle can be defined as:
Class Vehicle { Number no_of_wheels Number horsepower Characters type_of_tank Number Capacity Function speeding { } Function driving { } Function halting { } }
By assigning different values to these data members, you can form several instances of the class Vehicle. For example, an airplane has three wheels, horsepower of 1,000, fuel as the type of tank, and a capacity of 100 liters. In the same way, a car has four wheels, horsepower of 200, gas as the type of tank, and a capacity of 25 litres.
Defining a Class in Ruby:

To implement object-oriented programming by using Ruby, you need to first learn how to create objects and classes in Ruby. A class in Ruby always starts with the keyword class followed by the name of the class. The name should always be in initial capitals. The class Customer can be displayed as:
class Customer end

You terminate a class by using the keyword end. All the data members in the class are between the class definition and the end keyword.
Variables in a Ruby Class:

Ruby provides four types of variables:
Local Variables: Local variables are the variables that are defined in a method. Local variables are not available outside the method. You will see more detail about method in subsequent chapter. Local variables begin with a lowercase letter or _. Instance Variables: Instance variables are available across methods for any particular instance or object. That means that instance variables change from object to object. Instance variables are preceded by the at sign (@) followed by the variable name. Class Variables: Class variables are available across different objects. A class variable belongs to the class and is a characteristic of a class. They are preceded by the sign @@ and are followed by the variable name. Global Variables: Class variables are not available across classes. If you want to have a single variable, which is available across classes, you need to define a global variable. The global variables are always preceded by the dollar sign ($).
Example:
Using the class variable @@no_of_customers, you can determine the number of objects that are being created. This enables in deriving the number of customers.
class Customer @@no_of_customers=0 end
Creating Objects in Ruby using new Method:

Objects are instances of the class. You will now learn how to create objects of a class in Ruby. You can create objects in Ruby by using the method new of the class. The method new is a unique type of method, which is predefined in the Ruby library. The new method belongs to the class methods. Here is the example to create two objects cust1 and cust2 of the class Customer:
cust1 = Customer. new cust2 = Customer. new
Here, cust1 and cust2 are the names of two objects. You write the object name followed by the equal to sign (=) after which the class name will follow. Then, the dot operator and the keywordnew will follow.
Custom Method to create Ruby Objects :

You can pass parameters to method new and those parameters can be used to initialize class variables. When you plan to declare the new method with parameters, you need to declare the methodinitialize at the time of the class creation. The initialize method is a special type of method, which will be executed when the new method of the class is called with parameters. Here is the example to create initialize method:
class Customer @@no_of_customers=0 def initialize(id, name, addr) @cust_id=id @cust_name=name @cust_addr=addr end end
In this example, you declare the initialize method with id, name, and addr as local variables. Here def and end are used to define a Ruby method initialize. You will learn more about methods in subsequent chapters. In the initialize method, you pass on the values of these local variables to the instance variables @cust_id, @cust_name, and @cust_addr. Here local variables hold the values that are passed along with the new method. Now you can create objects as follows:
cust1=Customer.new("1", "John", "Wisdom Apartments, Ludhiya") cust2=Customer.new("2", "Poul", "New Empire road, Khandala")
Member Functions in Ruby Class:

In Ruby, functions are called methods. Each method in a class starts with the keyword deffollowed by the method name. The method name always preferred in lowercase letters. You end a method in Ruby by using the keyword end. Here is the example to define a Ruby method:
class Sample def function statement 1 statement 2 end end
Here statement 1 and statement 2 are part of the body of the method function inside the class Sample. These statments could be any valid Ruby statement. For example we can put a methodputs to print Hello Ruby as follows:
class Sample def hello puts "Hello Ruby!" end end

Now in the following example create one object of Sample class and call hello method and see the result:
#!/usr/bin/ruby class Sample def hello puts "Hello Ruby!" end end # Now using above class to create objects object = Sample. new object.hello
Hello Ruby!
Variables are the memory locations which holds any data to be used by any program. There are five types of variables supported by Ruby. You already have gone through a small description of these variables in previous chapter as well. These five types of variables are explained in this chapter.
Ruby Global Variables:

Global variables begin with $. Uninitialized global variables have the value nil and produce warnings with the -w option. Assignment to global variables alters global status. It is not recommended to use global variables. They make programs cryptic. Here is an example showing usage of global variable.
#!/usr/bin/ruby $global_variable = 10 class Class1 def print_global puts "Global variable in Class1 is #$global_variable" end end
class Class2 def print_global puts "Global variable in Class2 is #$global_variable" end end class1obj = Class1.new class1obj.print_global class2obj = Class2.new class2obj.print_global
Here $global_variable is a global variable. This will produce following result: NOTE: In Ruby you CAN access value of any variable or constant by putting a hash (#) character just before that variable or constant.
Global variable in Class1 is 10 Global variable in Class2 is 10
Ruby Instance Variables:

Instance variables begin with @. Uninitialized instance variables have the value nil and produce warnings with the -w option. Here is an example showing usage of Instance Variables.
#!/usr/bin/ruby class Customer def initialize(id, name, addr) @cust_id=id @cust_name=name @cust_addr=addr end def display_details() puts "Customer id #@cust_id" puts "Customer name #@cust_name" puts "Customer address #@cust_addr" end end # Create Objects cust1=Customer.new("1", "John", "Wisdom Apartments, Ludhiya") cust2=Customer.new("2", "Poul", "New Empire road, Khandala") # Call Methods cust1.display_details() cust2.display_details()
Here @cust_id, @cust_name and @cust_addr are instance variables. This will produce following result:
Customer Customer Customer Customer Customer
id 1 name John address Wisdom Apartments, Ludhiya id 2 name Poul
Customer address New Empire road, Khandala
Ruby Class Variables:

Class variables begin with @@ and must be initialized before they can be used in method definitions. Referencing an uninitialized class variable produces an error. Class variables are shared among descendants of the class or module in which the class variables are defined. Overriding class variables produce warnings with the -w option. Here is an example showing usage of class variable:
#!/usr/bin/ruby class Customer @@no_of_customers=0 def initialize(id, name, addr) @cust_id=id @cust_name=name @cust_addr=addr end def display_details() puts "Customer id #@cust_id" puts "Customer name #@cust_name" puts "Customer address #@cust_addr" end def total_no_of_customers() @@no_of_customers += 1 puts "Total number of customers: #@@no_of_customers" end end # Create Objects cust1=Customer.new("1", "John", "Wisdom Apartments, Ludhiya") cust2=Customer.new("2", "Poul", "New Empire road, Khandala") # Call Methods cust1.total_no_of_customers() cust2.total_no_of_customers()
Here @@no_of_customers is a class variable. This will produce following result:
Total number of customers: 1 Total number of customers: 2
Ruby Local Variables:

Local variables begin with a lowercase letter or _. The scope of a local variable ranges from class, module, def, or do to the corresponding end or from a block's opening brace to its close brace {}. When an uninitialized local variable is referenced, it is interpreted as a call to a method that has no arguments.
Assignment to uninitialized local variables also serves as variable declaration. The variables start to exist until the end of the current scope is reached. The lifetime of local variables is determined when Ruby parses the program. In the above example local variables are id, name and addr.
Ruby Constants:
Constants begin with an uppercase letter. Constants defined within a class or module can be accessed from within that class or module, and those defined outside a class or module can be accessed globally. Constants may not be defined within methods. Referencing an uninitialized constant produces an error. Making an assignment to a constant that is already initialized produces a warning.
#!/usr/bin/ruby class Example VAR1 = 100 VAR2 = 200 def show puts "Value of first Constant is #{VAR1}" puts "Value of second Constant is #{VAR2}" end end # Create Objects object=Example.new() object.show
Here VAR1 and VAR2 are constant. This will produce following result:
Value of first Constant is 100 Value of second Constant is 200
Ruby Pseudo-Variables:
They are special variables that have the appearance of local variables but behave like constants. You can not assign any value to these variables.
self: The receiver object of the current method. true: Value representing true. false: Value representing false. nil: Value representing undefined. __FILE__: The name of the current source file. __LINE__: The current line number in the source file.
Ruby Basic Literals:

The rules Ruby uses for literals are simple and intuitive. This section explains all basic Ruby Literals.
Integer Numbers:
Ruby supports integer numbers. An integer number can range from -230 to 230-1 or -262 to 262-1. Integers with-in this range are objects of class Fixnum and integers outside this range are stored in objects of class Bignum. You write integers using an optional leading sign, an optional base indicator (0 for octal, 0x for hex, or 0b for binary), followed by a string of digits in the appropriate base. Underscore characters are ignored in the digit string. You can also get the integer value corresponding to an ASCII character or escape sequence by preceding it with a question mark. Example:
123 1_234 -500 0377 0xff 0b1011 ?a ?\n 12345678901234567890
# # # # # # # # #
Fixnum decimal Fixnum decimal with underline Negative Fixnum octal hexadecimal binary character code for 'a' code for a newline (0x0a) Bignum
NOTE: Class and Objects are explained in a separate chapter of this tutorial.
Floating Numbers:
Ruby supports integer numbers. They are also numbers but with decimals. Floating-point numbers are objects of class Float and can be any of the following: Example:
123.4 1.0e6 4E20 4e+20
# # # #
floating point value scientific notation dot not required sign before exponential
String Literals:
Ruby strings are simply sequences of 8-bit bytes and they are objects of class String. Double-quoted strings allow substitution and backslash notation but single-quoted strings don't allow substitution and allow backslash notation only for \\ and \' Example:
#!/usr/bin/ruby -w puts 'escape using "\\"'; puts 'That\'s right';

escape using "\" That's right

You can substitute the value of any Ruby expression into a string using the sequence #{ expr }. Here expr could be any ruby expression.
#!/usr/bin/ruby -w puts "Multiplication Value : #{24*60*60}";

Multiplication Value : 86400
Backslash Notations:
Following is the list of Backslash notations supported by Ruby: Notation \n \r \f \b \a \e \s \nnn \xnn \cx, \C-x \M-x \M-\C-x Newline (0x0a) Carriage return (0x0d) Formfeed (0x0c) Backspace (0x08) Bell (0x07) Escape (0x1b) Space (0x20) Octal notation (n being 0-7) Hexadecimal notation (n being 0-9, a-f, or A-F) Control-x Meta-x (c | 0x80) Meta-Control-x Character represented
\x
Character x
For more detail on Ruby Strings, go through Ruby Strings.
Ruby Arrays:
Literals of Ruby Array are created by placing a comma-separated series of object references between square brackets. A trailing comma is ignored.
Example:
#!/usr/bin/ruby ary = [ "fred", 10, 3.14, "This is a string", "last element", ] ary.each do |i| puts i end
fred 10 3.14 This is a string last element

For more detail on Ruby Arrays, go through Ruby Arrays.
Ruby Hashes:
A literal Ruby Hash is created by placing a list of key/value pairs between braces, with either a comma or the sequence => between the key and the value. A trailing comma is ignored.
Example:
#!/usr/bin/ruby hsh = colors = { "red" => 0xf00, "green" => 0x0f0, "blue" => 0x00f } hsh.each do |key, value| print key, " is ", value, "\n" end
green is 240 blue is 15 red is 3840

For more detail on Ruby Hashes, go through Ruby Hashes.
Ruby Ranges:
A Range represents an interval.a set of values with a start and an end. Ranges may be constructed using the s..e and s...e literals, or with Range.new. Ranges constructed using .. run from the start to the end inclusively. Those created using ... exclude the end value. When used as an iterator, ranges return each value in the sequence. A range (1..5) means it includes 1, 2, 3, 4, 5 values and a range (1...5) means it includes 1, 2, 3, 4 values.
Example:
#!/usr/bin/ruby (10..15).each do |n| print n, ' ' end
10 11 12 13 14 15
Ruby supports a rich set of operators, as you'd expect from a modern language. Most operators are actually method calls. For example, a + b is interpreted as a.+(b), where the + method in the object referred to by variable a is called with b as its argument. For each operator (+ - * / % ** & | ^ << >> && ||), there is a corresponding form of abbreviated assignment operator (+= -= etc.)
Ruby Arithmetic Operators:

Assume variable a holds 10 and variable b holds 20 then: Operator + Description Addition - Adds values on either side of the operator Subtraction - Subtracts right hand operand from left hand operand Multiplication - Multiplies values on either side of the operator Division - Divides left hand operand by right hand operand a + b will give 30 Example
a - b will give -10
a * b will give 200
b / a will give 2
Modulus - Divides left hand operand by right hand operand and returns remainder Exponent - Performs exponential (power) calculation on operators
b % a will give 0
**
a**b will give 10 to the power 20
Ruby Comparison Operators:

Assume variable a holds 10 and variable b holds 20 then: Operator == Description Checks if the value of two operands are equal or not, if yes then condition becomes true. Checks if the value of two operands are equal or not, if values are not equal then condition becomes true. Checks if the value of left operand is greater than the value of right operand, if yes then condition becomes true. Example (a == b) is not true.
!=
(a != b) is true.
>
(a > b) is not true.
<
Checks if the value of left operand is less than (a < b) is true. the value of right operand, if yes then condition becomes true. Checks if the value of left operand is greater than or equal to the value of right operand, if yes then condition becomes true. Checks if the value of left operand is less than or equal to the value of right operand, if yes then condition becomes true. (a >= b) is not true.
>=
<=
(a <= b) is true.
<=>
Combined comparison operator. Returns 0 if (a <=> b) returns -1. first operand equals second, 1 if first operand is greater than the second and -1 if first operand is less than the second. Used to test equality within a when clause of a case statement. True if the receiver and argument have both the same type and equal values. (1...10) === 5 returns true.
===
.eql?
1 == 1.0 returns true, but 1.eql?(1.0) is false.
equal?
True if the receiver and argument have the same object id.
1 == 1.0 returns true, but 1.eql?(1.0) is false.
Ruby Assignment Operators:

Assume variable a holds 10 and variable b holds 20 then: Operator = Description Simple assignment operator, Assigns values from right side operands to left side operand Add AND assignment operator, It adds right operand to the left operand and assign the result to left operand Subtract AND assignment operator, It subtracts right operand from the left operand and assign the result to left operand Multiply AND assignment operator, It multiplies right operand with the left operand and assign the result to left operand Divide AND assignment operator, It divides left operand with the right operand and assign the result to left operand Modulus AND assignment operator, It takes modulus using two operands and assign the result to left operand Exponent AND assignment operator, Performs exponential (power) calculation on operators and assign value to the left operand Example c = a + b will assigne value of a + b into c
+=
c += a is equivalent to c = c + a
-=
c -= a is equivalent to c = c - a
*=
c *= a is equivalent to c = c * a
/=
c /= a is equivalent to c = c / a
%=
c %= a is equivalent to c = c % a
**=
c **= a is equivalent to c = c ** a
Ruby Parallel Assignment:

Ruby also supports the parallel assignment of variables. This enables multiple variables to be initialized with a single line of Ruby code. For example:
a = 10 b = 20 c = 30
may be more quickly declared using parallel assignment:
a, b, c = 10, 20, 30
Parallel assignment is also useful for swapping the values held in two variables:
a, b = b, c
Ruby Bitwise Operators:

Bitwise operator works on bits and perform bit by bit operation. Assume if a = 60; and b = 13; Now in binary format they will be as follows: a = 0011 1100 b = 0000 1101 ----------------a&b = 0000 1100 a|b = 0011 1101 a^b = 0011 0001 ~a = 1100 0011 There are following Bitwise operators supported by Ruby language Operator & Description Binary AND Operator copies a bit to the result if it exists in both operands. Binary OR Operator copies a bit if it exists in eather operand. Binary XOR Operator copies the bit if it is set in one operand but not both. Binary Ones Complement Operator is unary and has the efect of 'flipping' bits. Example (a & b) will give 12 which is 0000 1100
(a | b) will give 61 which is 0011 1101
(a ^ b) will give 49 which is 0011 0001
(~a ) will give -60 which is 1100 0011
<<
Binary Left Shift Operator. The left operands value is moved left by the number of bits specified by the right operand. Binary Right Shift Operator. The left operands value is moved right by the number of bits specified by the right operand.
a << 2 will give 240 which is 1111 0000
>>
a >> 2 will give 15 which is 0000 1111
Ruby Logical Operators:

There are following logical operators supported by Ruby language Assume variable a holds 10 and variable b holds 20 then: Operator and Description Called Logical AND operator. If both the operands are true then then condition becomes true. Called Logical OR Operator. If any of the two operands are non zero then then condition becomes true. Called Logical AND operator. If both the operands are non zero then then condition becomes true. Called Logical OR Operator. If any of the two operands are non zero then then condition becomes true. Called Logical NOT Operator. Use to reverses the logical state of its operand. If a condition is true then Logical NOT operator will make false. Called Logical NOT Operator. Use to reverses the logical state of its operand. If a condition is true then Logical NOT operator will make false. (a and b) is true. Example
or
(a or b) is true.
&&
(a && b) is true.
||
(a || b) is true.
!(a && b) is false.
not
not(a && b) is false.
Ruby Ternary operator:

There is one more oprator called Ternary Operator. This first evaluates an expression for a true or false value and then execute one of the two given statements depending upon the result of the evaluation. The conditioanl operator has this syntax:
Operator ?:
Description Conditional Expression
Example If Condition is true ? Then value X : Otherwise value Y
Ruby Range operators:

Sequence ranges in Ruby are used to create a range of successive values - consisting of a start value, an end value and a range of values in between. In Ruby, these sequences are created using the ".." and "..." range operators. The two-dot form creates an inclusive range, while the three-dot form creates a range that excludes the specified high value. Operator .. Description Creates a range from start point to end point inclusive Creates a range from start point to end point exclusive Example 1..10 Creates a range from 1 to 10 inclusive
...
1...10 Creates a range from 1 to 9
Ruby defined? operators:

defined? is a special operator that takes the form of a method call to determine whether or not the passed expression is defined. It returns a description string of the expression, or nil if the expression isn't defined. There are various usage of defined? operator:
Usage 1
defined? variable # True if variable is initialized
For Example:
foo = 42 defined? foo defined? $_ defined? bar
# => "local-variable" # => "global-variable" # => nil (undefined)
Usage 2
defined? method_call # True if a method is defined
For Example:
defined? puts
# => "method"
defined? puts(bar) defined? unpack
# => nil (bar is not defined here) # => nil (not defined here)
Usage 3
# True if a method exists that can be called with super user defined? super
For Example:
defined? super defined? super
# => "super" (if it can be called) # => nil (if it cannot be)
Usage 4
defined? yield
For Example:
# True if a code block has been passed
defined? yield defined? yield
# => "yield" (if there is a block passed) # => nil (if there is no block)
Ruby dot "." and double Colon "::" Operators:

You call a module method by preceding its name with the module's name and aperiod, and you reference a constant using the module name and two colons. The :: is a unary operator that allows: constants, instance methods and class methods defined within a class or module, to be accessed from anywhere outside the class or module. Remember: in Ruby, classes and methods may be considered constants too. You need just to prefix the :: Const_name with an expression that returns the appropriate class or module object. If no prefix expression is used, the main Object class is used by default. Here are two examples:
MR_COUNT = 0 module Foo MR_COUNT = 0 ::MR_COUNT = 1 MR_COUNT = 2 end puts MR_COUNT puts Foo::MR_COUNT
Second Example:
# constant defined on main Object class # set global count to 1 # set local count to 2 # this is the global constant # this is the local "Foo" constant
CONST = ' out there'
class Inside_one CONST = proc {' in there'} def where_is_my_CONST ::CONST + ' inside one' end end class Inside_two CONST = ' inside two' def where_is_my_CONST CONST end end puts Inside_one.new.where_is_my_CONST puts Inside_two.new.where_is_my_CONST puts Object::CONST + Inside_two::CONST puts Inside_two::CONST + CONST puts Inside_one::CONST puts Inside_one::CONST.call + Inside_two::CONST
Ruby Operators Precedence

The following table lists all operators from highest precedence to lowest. Method Yes Yes Yes Yes :: [ ] [ ]= ** !~+Operator Description Constant resolution operator Element reference, element set Exponentiation (raise to the power) Not, complement, unary plus and minus (method names for the last two are +@ and -@) Multiply, divide, and modulo Addition and subtraction Right and left bitwise shift Bitwise 'AND' Bitwise exclusive ÒR' and regular ÒR' Comparison operators Equality and pattern match operators (!= and !~ may not be defined as methods)
Yes Yes Yes Yes Yes Yes Yes
*/% +>> << & ^| <= < > >= <=> == === != =~ !~
&& || .. ... ?: = %= { /= -= += |= &= >>= <<= *= &&= ||= **= defined? not or and
Logical 'AND' Logical 'OR' Range (inclusive and exclusive) Ternary if-then-else Assignment
Check if specified symbol defined Logical negation Logical composition
NOTE: Operators with a Yes in the method column are actually methods, and as such may be overridden. Comments are lines of annotation within Ruby code that are ignored at runtime. A single line comment starts with # charcter and they extend from # to the end of the line as follows:
#!/usr/bin/ruby -w # This is a single line comment. puts "Hello, Ruby!";
Ruby Multiline Comments

You can comment multiple lines using =begin and =end syntax as follows:
#!/usr/bin/ruby -w puts "Hello, Ruby!"; =begin This is a multiline comment and con spwan as many lines as you like. But =begin and =end should come in the first line only. =end
Make sure trailing comments are far enough from the code that it is easily distinguished. If more than one trailing comment exists in a block, align them. For example:
@counter @siteCounter
# keeps track times page has been hit # keeps track of times all pages have been hit
****************************************************************************** ******
Ruby offers contional structures that are pretty common to modern languages. Here we will explain all the conditional statements and modifiers available in Ruby
Ruby if...else Statement:

Syntax:
if conditional [then] code... [elsif conditional [then] code...]... [else code...] end
if expressions are used for conditional execution. The values false and nil are false, and everything else are true. Notice Ruby uses elsif, not else if nor elif. Executes code if the conditional is true. If the conditional is not true, code specified in the else clause is executed. An if expression's conditional is separated from code by the reserved word then, a newline, or a semicolon.
Example:
#!/usr/bin/ruby x=1 if x > 2 puts "x elsif x <= puts "x else puts "I end
is greater than 2" 2 and x!=0 is 1" can't guess the number"
x is 1
Ruby if modifier:
Syntax:
code if condition
Executes code if the conditional is true.
Example:
#!/usr/bin/ruby $debug=1 print "debug\n" if $debug
debug
Ruby unless Statement:

Syntax:
unless conditional [then] code [else code ] end
Executes code if conditional is false. If the conditional is true, code specified in the else clause is executed.
Example:
#!/usr/bin/ruby x=1 unless x>2 puts "x is less than 2" else puts "x is greater than 2" end
x is less than 2
Ruby unless modifier:

Syntax:
code unless conditional
Executes code if conditional is false.
Example:
#!/usr/bin/ruby $var = 1
print "1 -- Value is set\n" if $var print "2 -- Value is set\n" unless $var $var = false print "3 -- Value is set\n" unless $var
1 -- Value is set 3 -- Value is set
Ruby case Statement

Syntax:
case expression [when expression [, expression ...] [then] code ]... [else code ] end
Compares the expression specified by case and that specified by when using the === operator and executes the code of the when clause that matches. The expression specified by the when clause is evaluated as the left operand. If no when clauses match, case executes the code of the else clause. A when statement's expression is separated from code by the reserved word then, a newline, or a semicolon. Thus:
case expr0 when expr1, expr2 stmt1 when expr3, expr4 stmt2 else stmt3 end
is basically similar to the following:
_tmp = expr0 if expr1 === _tmp || expr2 === _tmp stmt1 elsif expr3 === _tmp || expr4 === _tmp stmt2 else stmt3 end
Example:
#!/usr/bin/ruby $age = 5 case $age when 0 .. 2 puts "baby" when 3 .. 6 puts "little child" when 7 .. 12 puts "child" when 13 .. 18 puts "youth" else puts "adult" end
little child
Loops in Ruby are used to execute the same block of code a specified number of times. This chapter details all the loop statements supported by Ruby.
Ruby while Statement:

Syntax:
while conditional [do] code end
Executes code while conditional is true. A while loop's conditional is separated from code by the reserved word do, a newline, backslash \, or a semicolon ;.
Example:
#!/usr/bin/ruby $i = 0; $num = 5; while $i < $num do puts("Inside the loop i = #$i" ); $i +=1; end
Inside the loop i = 0 Inside the loop i = 1 Inside the loop i = 2
Inside the loop i = 3 Inside the loop i = 4
Ruby while modifier:

Syntax:
code while condition OR begin code end while conditional
Executes code while conditional is true. If a while modifier follows a begin statement with no rescue or ensure clauses, code is executed once before conditional is evaluated.
Example:
#!/usr/bin/ruby $i = 0; $num = 5; begin puts("Inside the loop i = #$i" ); $i +=1; end while $i < $num
Inside Inside Inside Inside Inside
the the the the the
loop loop loop loop loop
i i i i i
= = = = =
0 1 2 3 4
Ruby until Statement:

Syntax:
until conditional [do] code end
Executes code while conditional is false. An until statement's conditional is separated from codeby the reserved word do, a newline, or a semicolon.
Example:
#!/usr/bin/ruby
$i = 0; $num = 5; until $i > $num do puts("Inside the loop i = #$i" ); $i +=1; end
Inside Inside Inside Inside Inside Inside
the the the the the the
loop loop loop loop loop loop
i i i i i i
= = = = = =
0 1 2 3 4 5
Ruby until modifier:

Syntax:
code until conditional OR begin code end until conditional
Executes code while conditional is false. If an until modifier follows a begin statement with no rescue or ensure clauses, code is executed once before conditional is evaluated.
Example:
#!/usr/bin/ruby $i = 0; $num = 5; begin puts("Inside the loop i = #$i" ); $i +=1; end until $i > $num
Inside Inside Inside Inside Inside Inside
the the the the the the
loop loop loop loop loop loop
i i i i i i
= = = = = =
0 1 2 3 4 5
Ruby for Statement:

Syntax:
for variable [, variable ...] in expression [do] code end
Executes code once for each element in expression.
Example:
#!/usr/bin/ruby for i in 0..5 puts "Value of local variable is #{i}" end
Here we have defined the range 0..5. The statement for i in 0..5 will allow i to take values in the range from 0 to 5 (including 5).This will produce following result:
Value Value Value Value Value Value
of of of of of of
local local local local local local
variable variable variable variable variable variable
is is is is is is
0 1 2 3 4 5
A for...in loop is almost exactly equivalent to:
(expression).each do |variable[, variable...]| code end

except that a for loop doesn't create a new scope for local variables. A for loop's expression is separated from code by the reserved word do, a newline, or a semicolon.
Example:
#!/usr/bin/ruby (0..5).each do |i| puts "Value of local variable is #{i}" end
Value Value Value Value Value Value
of of of of of of
local local local local local local
variable variable variable variable variable variable
is is is is is is
0 1 2 3 4 5
Ruby break Statement:

Syntax:
break
Terminates the most internal loop. Terminates a method with an associated block if called within the block (with the method returning nil).
Example:
#!/usr/bin/ruby for i in 0..5 if i > 2 then break end puts "Value of local variable is #{i}" end
Value of local variable is 0 Value of local variable is 1 Value of local variable is 2
Ruby next Statement:

Syntax:
next
Jumps to next iteration of the most internal loop. Terminates execution of a block if called within a block (with yield or call returning nil).
Example:
#!/usr/bin/ruby for i in 0..5 if i < 2 then next end puts "Value of local variable is #{i}" end
Value Value Value Value
of of of of
local local local local
variable variable variable variable
is is is is
2 3 4 5
Ruby redo Statement:

Syntax:
redo
Restarts this iteration of the most internal loop, without checking loop condition. Restarts yield orcall if called within a block.
Example:
#!/usr/bin/ruby for i in 0..5 if i < 2 then puts "Value of local variable is #{i}" redo end end
This will produce following result and will go in an infinite loop:
Value of local variable is 0 Value of local variable is 0 ............................
Ruby retry Statement:

Syntax:
retry
If retry appears in rescue clause of begin expression, restart from the beginning of the 1begin body.
begin do_something # exception raised rescue # handles error retry # restart from beginning end
If retry appears in the iterator, the block, or the body of the for expression, restarts the invocation of the iterator call. Arguments to the iterator is re-evaluated.
for i in 1..5 retry if some_condition # restart from i == 1 end
Example:
#!/usr/bin/ruby
for i in 1..5 retry if i > 2 puts "Value of local variable is #{i}" end
This will produce following result and will go in an infinite loop:
Value of local variable is 1 Value of local variable is 2 Value of local variable is 1 Value of local variable is 2 Value of local variable is 1 Value of local variable is 2 ............................
Ruby methods are very similar to functions in any other programming language. Ruby methods are used to bundle one or more repeatable statements into a single unit. Method names should begin with a lowercase letter. If you begin a method name with an uppercase letter, Ruby might think that it is a constant and hence can parse the call incorrectly. Methods should be defined before calling them otherwise Ruby will raise an exception for undefined method invoking.
Syntax:
def method_name [( [arg [= default]]...[, * arg [, &expr ]])] expr.. end
So you can define a simple method as follows:
def method_name expr.. end

You can represent a method that accepts parameters like this:
def method_name (var1, var2) expr.. end

You can set default values for the parameters which will be used if method is called without passing required parameters:
def method_name (var1=value1, var2=value2) expr.. end

Whenever you call the simple method, you write only the method name as follows:
method_name
However, when you call a method with parameters, you write the method name along with the parameters, such as:
method_name 25, 30
The most important drawback to using methods with parameters is that you need to remember the number of parameters whenever you call such methods. For example, if a method accepts three parameters and you pass only two, then Ruby displays an error.
Example:
#!/usr/bin/ruby def test(a1="Ruby", a2="Perl") puts "The programming language is #{a1}" puts "The programming language is #{a2}" end test "C", "C++" test
The The The The
programming programming programming programming
language language language language
is is is is
C C++ Ruby Perl
Return Values from Methods:

Every method in Ruby returns a value by default. This returned value will be the value of the last statement. For example:
def test i = 100 j = 10 k = 0 end

This method, when called, will return the last declared variable k.
Ruby return Statement:

The return statement in ruby is used to return one or more values from a Ruby Method.
Syntax:
return [expr[`,' expr...]]
If more than two expressions are given, the array contains these values will be the return value. If no expression given, nil will be the return value.
Example:
return OR return 12 OR return 1,2,3
Have a look at this example:
#!/usr/bin/ruby def test i = 100 j = 200 k = 300 return i, j, k end var = test puts var
100 200 300
Variable Number of Parameters:

Suppose that you declare a method that takes two parameters. Whenever you call this method, you need to pass two parameters along with it. However, Ruby allows you to declare methods that work with a variable number of parameters. Let us examine a sample of this:
#!/usr/bin/ruby def sample (*test) puts "The number of parameters is #{test.length}" for i in 0...test.length puts "The parameters are #{test[i]}" end end sample "Zara", "6", "F" sample "Mac", "36", "M", "MCA"
In this code, you have declared a method sample that accepts one parameter test. However, this parameter is a variable parameter. This means that this parameter can take in any number of variables. So above code will produce following result:
The The The The The The The The The
number of parameters is 3 parameters are Zara parameters are 6 parameters are F number of parameters is 4 parameters are Mac parameters are 36 parameters are M parameters are MCA
Class Methods:
When a method is defined outside of the class definition, the method is marked as private by default. On the other hand, the methods defined in the class definition are marked as public by default. The default visibility and the private mark of the methods can be changed by public orprivate of the Module. Whenever you want to access a method of a class, you first need to instantiate the class. Then, using the object, you can access any member of the class. Ruby gives you a way to access a method without instantiating a class. Let us see how a class method is declared and accessed:
class Accounts def reading_charge end def Accounts.return_date end end

See how the method return_date is declared. It is declared with the class name followed by a period, which is followed by the name of the method. You can access this class method directly as follows:
Accounts.return_date
To access this method, you need not create objects of the class Accounts.
Ruby alias Statement:

This gives alias to methods or global variables. Aliases can not be defined within the method body. The aliase of the method keep the current definition of the method, even when methods are overridden. Making aliases for the numbered global variables ($1, $2,...) is prohibited. Overriding the builtin global variables may cause serious problems.
Synatx:
alias method-name method-name alias global-variable-name global-variable-name
Example:
alias foo bar alias $MATCH $&
Here we have defined boo alias for bar and $MATCH is an alias for $&
Ruby undef Statement:

This cancels the method definition. An undef can not appear in the method body. By using undef and alias, the interface of the class can be modified independently from the superclass, but notice it may be broke programs by the internal method call to self.
Synatx:
undef method-name
Example:
To undefine a method called bar do the following:
undef bar
You have seen how Ruby defines methods where you can put number of statements and then you call that method. Similarly Ruby has a concept of Bolck.
A block consists of chunks of code. You assign a name to a block. The code in the block is always enclosed within braces ({}). A block is always invoked from a function with the same name as that of the block. This means that if you have a block with the name test, then you use the function test to invoke this block. You invoke a block by using the yield statement.
Syntax:
block_name{ statement1 statement2 .......... }
Here you will learn to invoke a block by using a simple yield statement. You will also learn to use a yield statement with parameters for invoking a block. You will check the sample code with both types of yield statements.
The yield Statement:

Let.s look at an example of the yield statement:
#!/usr/bin/ruby def test puts "You are in the method" yield puts "You are again back to the method" yield end test {puts "You are in the block"}
You You You You
are are are are
in the method in the block again back to the method in the block
You also can pass parameters with the yield statement. Here is an example:
#!/usr/bin/ruby def test yield 5 puts "You are in the method test" yield 100 end test {|i| puts "You are in the block #{i}"}
You are in the block 5 You are in the method test You are in the block 100
Here the yield statement is written followed by parameters. You can even pass more than one parameter. In the block, you place a variable between two vertical lines (||) to accept the parameters. Therefore, in the preceding code, the yield 5 statement passes the value 5 as a parameter to the test block. Now look at the following statement:
test {|i| puts "You are in the block #{i}"}

Here the value 5 is received in the variable i. Now observe the following puts statement:
puts "You are in the block #{i}"

The output of this puts statement is:
You are in the block 5

If you want to pass more than one parameters, then the yield statement becomes:
yield a, b
and the block is:
test {|a, b| statement}

The parameters will be separated by commas.
Blocks and Methods:

You have seen how how a block and a method can be associated with each other.You normally invoke a block by using the yield statement from a method that has the same name as that of the block. Therefore, you write:
def test yield end test{ puts "Hello world"}

This example is the simplest way to implement a block.You call the test block by using the yieldstatement. But if the last argument of a method is preceded by &, then you can pass a block to this method and this block will be assigned to the last parameter. In case both * and & are present in the argument list, & should come later.
def test(&block) block.call end test { puts "Hello World!"}

Hello World!
BEGIN and END Blocks

Every Ruby source file can declare blocks of code to be run as the file is being loaded (the BEGIN blocks) and after the program has finished executing (the END blocks).
BEGIN { begin block code } END { end block code }

A program may include multiple BEGIN and END blocks. BEGIN blocks are executed in the order they are encountered. END blocks are executed in reverse order.
Modules are a way of grouping together methods, classes, and constants. Modules give you two major benefits.
Modules provide a namespace and prevent name clashes. Modules implement the mixin facility.
Modules define a namespace, a sandbox in which your methods and constants can play without having to worry about being stepped on by other methods and constants.
Syntax:
module Identifier statement1 statement2 ........... end
Module constants are named just like class constants, with an initial uppercase letter. The method definitions look similar, too: module methods are defined just like class methods. As with class methods, you call a module method by preceding its name with the module.s name and a period, and you reference a constant using the module name and two colons.
Example:
#!/usr/bin/ruby # Module defined in trig.rb file module Trig PI = 3.141592654 def Trig.sin(x) # .. end def Trig.cos(x) # .. end end
We can define one more module with same function name but different functionality:
#!/usr/bin/ruby # Module defined in moral.rb file module Moral VERY_BAD = 0 BAD = 1 def Moral.sin(badness) # ... end end
Like class methods, whenever you define a method in a module, you specify the module name followed by a dot and then the method name.
Ruby require Statement:

The require statement is similar to the include statement of C and C++ and the import statement of Java. If a third program wants to use any defined module, it can simply load the module files using the Ruby require statement:
Syntax:
require filename
Here it is not required to give .rb extension along with a file name.
Example:
require 'trig.rb' require 'moral' y = Trig.sin(Trig::PI/4) wrongdoing = Moral.sin(Moral::VERY_BAD)
IMPORTANT: Here both the files contain same function name. So this will result in code ambiguity while including in calling program but modules avoid this code ambiguity and we are able to call appropriate function using module name.
Ruby include Statement:

You can embed a module in a class. To embed a module in a class, you use the includestatement in the class:
Syntax:
include modulename
If a module is defined in separate file then it is required to include that file using requirestatement before embeding module in a class.
Example:
Consider following module written in Week.rb file.
module Week FIRST_DAY = "Sunday" def Week.weeks_in_month puts "You have four weeks in a month" end def Week.weeks_in_year puts "You have 52 weeks in a year" end end
Now you can include this module in a class as follows:
#!/usr/bin/ruby require "Week" class Decade include Week no_of_yrs=10 def no_of_months puts Week::FIRST_DAY number=10*12 puts number end end d1=Decade.new puts Week::FIRST_DAY Week.weeks_in_month Week.weeks_in_year d1.no_of_months
Sunday You have four weeks in a month You have 52 weeks in a year Sunday 120
Mixins in Ruby:
Before going through this section, I assume you have knowledge of Object Oriented Concepts. When a class can inherit features from more than one parent class, the class is supposed to show multiple inheritance. Ruby does not suppoprt mutiple inheritance directly but Ruby Modules have another, wonderful use. At a stroke, they pretty much eliminate the need for multiple inheritance, providing a facility called a mixin. Mixins give you a wonderfully controlled way of adding functionality to classes. However, their true power comes out when the code in the mixin starts to interact with code in the class that uses it. Let us examine the following sample code to gain an understand of mixin:
module def end def end end module def end def end end
A a1 a2 B b1 b2
class Sample include A
include B def s1 end end samp=Sample.new samp.a1 samp.a2 samp.b1 samp.b2 samp.s1
Module A consists of the methods a1 and a2. Module B consists of the methods b1 and b2. The class Sample includes both modules A and B. The class Sample can access all four methods, namely, a1, a2, b1, and b2. Therefore, you can see that the class Sample inherits from both the modules. Thus you can say the class Sample shows multiple inheritance or a mixin. A String object in Ruby holds and manipulates an arbitrary sequence of one or more bytes, typically representing characters that represent human language. The simplest string literals are enclosed in single quotes (the apostrophe character). The text within the quote marks is the value of the string:
'This is a simple Ruby string literal'

If you need to place an apostrophe within a single-quoted string literal, precede it with a backslash so that the Ruby interpreter does not think that it terminates the string:
'Won\'t you read O\'Reilly\'s book?'

The backslash also works to escape another backslash, so that the second backslash is not itself interpreted as an escape character. Following are string-related features Ruby.
Expression Substitution:
Expression substitution is a means of embedding the value of any Ruby expression into a string using #{ and }:
#!/usr/bin/ruby x, y, z = puts "The puts "The puts "The 12, 36, 72 value of x is #{ x }." sum of x and y is #{ x + y }." average was #{ (x + y + z)/3 }."
The value of x is 12. The sum of x and y is 48. The average was 40.
General Delimited Strings:

With general delimited strings, you can create strings inside a pair of matching though arbitrary delimiter characters, e.g., !, (, {, <, etc., preceded by a percent character (%). Q, q, and x have special meanings. General delimited strings can be nested:
%{Ruby is fun.} equivalent to "Ruby is fun." %Q{ Ruby is fun. } equivalent to " Ruby is fun. " %q[Ruby is fun.] equivalent to a single-quoted string %x!ls! equivalent to back tick command output `ls`
Escape Characters:
Following table is a list of escape or non-printable characters that can be represented with backslash notation. NOTE: In a doublequoted string, an escape character is interpreted; in a singlequoted string, an escape character is preserved. Backslash notation \a \b \cx \C-x \e \f \M-\C-x \n \nnn \r \s \t 0x0d 0x20 0x09 0x0a 0x1b 0x0c Hexadecimal character 0x07 0x08 Bell or alert Backspace Control-x Control-x Escape Formfeed Meta-Control-x Newline Octal notation, where n is in the range 0.7 Carriage return Space Tab
Description
\v \x \xnn
0x0b
Vertical tab Character x Hexadecimal notation, where n is in the range 0.9, a.f, or A.F
Character Encoding:
The default character set for Ruby is ASCII, whose characters may be represented by single bytes. If you use UTF-8, or another modern character set, characters may be represented in one to four bytes. You can change your character set using $KCODE at the beginning of your program, like this:
$KCODE = 'u'
Following are the possible values for $KCODE. Code a e n u Description ASCII (same as none). This is the default. EUC. None (same as ASCII). UTF-8.
String Built-in Methods:

We need to have an instance of String object to call a String method. Following is the way to create an instance of String object:
new [String.new(str="")]
This will returns a new string object containing a copy of str. Now using str object we can all any available instance methods. For example:
#!/usr/bin/ruby myStr = String.new("THIS IS TEST") foo = myStr.downcase puts "#{foo}"
this is test
Following are the public String methods ( Assuming str is a String object ): SN 1 Methods with Description str % arg Formats a string using a format specification. arg must be an array if it contains more than one substitution. For information on the format specification. see sprintf under "Kernel Module." str * integer Returns a new string containing integer times str. In other words, str is repeated integer imes. str + other_str Concatenates other_str to str. str << obj Concatenates an object to str. If the object is a Fixnum in the range 0.255, it is converted to a character. Compare it with concat. str <=> other_str Compares str with other_str, returning -1 (less than), 0 (equal), or 1 (greater than). The comparison is casesensitive. str == obj Tests str and obj for equality. If obj is not a String, returns false; returns true if str <=> obj returns 0. str =~ obj Matches str against a regular expression pattern obj. Returns the position where the match starts; otherwise, false. str =~ obj Matches str against a regular expression pattern obj. Returns the position where the match starts; otherwise, false. str.capitalize Capitalizes a string. str.capitalize! Same as capitalize, but changes are made in place.
10
11
str.casecmp Makes a case-insensitive comparison of strings. str.center Centers a string. str.chomp Removes the record separator ($/), usually \n, from the end of a string. If no record separator exists, does nothing. str.chomp! Same as chomp, but changes are made in place. str.chop Removes the last character in str. str.chop! Same as chop, but changes are made in place. str.concat(other_str) Concatenates other_str to str. str.count(str, ...) Counts one or more sets of characters. If there is more than one set of characters, counts the intersection of those sets str.crypt(other_str) Applies a one-way cryptographic hash to str. The argument is the salt string, which should be two characters long, each character in the range a.z, A.Z, 0.9, . or /. str.delete(other_str, ...) Returns a copy of str with all characters in the intersection of its arguments deleted. str.delete!(other_str, ...) Same as delete, but changes are made in place. str.downcase Returns a copy of str with all uppercase letters replaced with lowercase. str.downcase! Same as downcase, but changes are made in place. str.dump Returns a version of str with all nonprinting characters replaced by \nnn notation and all special characters escaped.
12
13
14
15
16
17
18
19
20
21
22
23
24
25
str.each(separator=$/) { |substr| block } Splits str using argument as the record separator ($/ by default), passing each substring to the supplied block. str.each_byte { |fixnum| block } Passes each byte from str to the block, returning each byte as a decimal representation of the byte. str.each_line(separator=$/) { |substr| block } Splits str using argument as the record separator ($/ by default), passing each substring to the supplied block. str.empty? Returns true if str is empty (has a zero length). str.eql?(other) Two strings are equal if the have the same length and content. str.gsub(pattern, replacement) [or] str.gsub(pattern) { |match| block } Returns a copy of str with all occurrences of pattern replaced with either replacement or the value of the block. The pattern will typically be a Regexp; if it is a String then no regular expression metacharacters will be interpreted (that is, /\d/ will match a digit, but '\d' will match a backslash followed by a 'd') str[fixnum] [or] str[fixnum,fixnum] [or] str[range] [or] str[regexp] [or] str[regexp, fixnum] [or] str[other_str] References str, using the following arguments: one Fixnum, returns a character code at fixnum; two Fixnums, returns a substring starting at an offset (first fixnum) to length (second fixnum); range, returns a substring in the range; regexp returns portion of matched string; regexp with fixnum, returns matched data at fixnum; other_str returns substring matching other_str. A negative Fixnum starts at end of string with -1. str[fixnum] = fixnum [or] str[fixnum] = new_str [or] str[fixnum, fixnum] = new_str [or] str[range] = aString [or] str[regexp] =new_str [or] str[regexp, fixnum] =new_str [or] str[other_str] = new_str ] Replace (assign) all or part of a string. Synonym of slice!. str.gsub!(pattern, replacement) [or] str.gsub!(pattern) { |match| block } Performs the substitutions of String#gsub in place, returning str, or nil if no substitutions were performed. str.hash Returns a hash based on the string's length and content. str.hex Treats leading characters from str as a string of hexadecimal digits (with an optional sign
26
27
28
29
30
31
32
33
34
35
and an optional 0x) and returns the corresponding number. Zero is returned on error. 36 str.include? other_str [or] str.include? fixnum Returns true if str contains the given string or character. str.index(substring [, offset]) [or] str.index(fixnum [, offset]) [or] str.index(regexp [, offset]) Returns the index of the first occurrence of the given substring, character (fixnum), or pattern (regexp) in str. Returns nil if not found. If the second parameter is present, it specifies the position in the string to begin the search. str.insert(index, other_str) Inserts other_str before the character at the given index, modifying str. Negative indices count from the end of the string, and insert after the given character. The intent is to insert a string so that it starts at the given index. str.inspect Returns a printable version of str, with special characters escaped. str.intern [or] str.to_sym Returns the Symbol corresponding to str, creating the symbol if it did not previously exist. str.length Returns the length of str. Compare size. str.ljust(integer, padstr=' ') If integer is greater than the length of str, returns a new String of length integer with str left-justified and padded with padstr; otherwise, returns str. str.lstrip Returns a copy of str with leading whitespace removed. str.lstrip! Removes leading whitespace from str, returning nil if no change was made. str.match(pattern) Converts pattern to a Regexp (if it isn't already one), then invokes its match method on str. str.oct Treats leading characters of str as a string of octal digits (with an optional sign) and returns the corresponding number. Returns 0 if the conversion fails. str.replace(other_str)
37
38
39
40
41
42
43
44
45
46
47
Replaces the contents and taintedness of str with the corresponding values in other_str. 48 str.reverse Returns a new string with the characters from str in reverse order. str.reverse! Reverses str in place. str.rindex(substring [, fixnum]) [or] str.rindex(fixnum [, fixnum]) [or] str.rindex(regexp [, fixnum]) Returns the index of the last occurrence of the given substring, character (fixnum), or pattern (regexp) in str. Returns nil if not found. If the second parameter is present, it specifies the position in the string to end the search.characters beyond this point won't be considered. str.rjust(integer, padstr=' ') If integer is greater than the length of str, returns a new String of length integer with str right-justified and padded with padstr; otherwise, returns str. str.rstrip Returns a copy of str with trailing whitespace removed. str.rstrip! Removes trailing whitespace from str, returning nil if no change was made. str.scan(pattern) [or] str.scan(pattern) { |match, ...| block } Both forms iterate through str, matching the pattern (which may be a Regexp or a String). For each match, a result is generated and either added to the result array or passed to the block. If the pattern contains no groups, each individual result consists of the matched string, $&. If the pattern contains groups, each individual result is itself an array containing one entry per group. str.slice(fixnum) [or] str.slice(fixnum, fixnum) [or] str.slice(range) [or] str.slice(regexp) [or] str.slice(regexp, fixnum) [or] str.slice(other_str) See str[fixnum], etc. str.slice!(fixnum) [or] str.slice!(fixnum, fixnum) [or] str.slice!(range) [or] str.slice!(regexp) [or] str.slice!(other_str) Deletes the specified portion from str, and returns the portion deleted. The forms that take a Fixnum will raise an IndexError if the value is out of range; the Range form will raise a RangeError, and the Regexp and String forms will silently ignore the assignment. str.split(pattern=$;, [limit]) Divides str into substrings based on a delimiter, returning an array of these substrings.
49
50
51
52
53
54
55
56
If pattern is a String, then its contents are used as the delimiter when splitting str. If pattern is a single space, str is split on whitespace, with leading whitespace and runs of contiguous whitespace characters ignored. If pattern is a Regexp, str is divided where the pattern matches. Whenever the pattern matches a zero-length string, str is split into individual characters. If pattern is omitted, the value of $; is used. If $; is nil (which is the default), str is split on whitespace as if ` ` were specified. If the limit parameter is omitted, trailing null fields are suppressed. If limit is a positive number, at most that number of fields will be returned (if limit is 1, the entire string is returned as the only entry in an array). If negative, there is no limit to the number of fields returned, and trailing null fields are not suppressed. 57 str.squeeze([other_str]*) Builds a set of characters from the other_str parameter(s) using the procedure described for String#count. Returns a new string where runs of the same character that occur in this set are replaced by a single character. If no arguments are given, all runs of identical characters are replaced by a single character. str.squeeze!([other_str]*) Squeezes str in place, returning either str, or nil if no changes were made. str.strip Returns a copy of str with leading and trailing whitespace removed. str.strip! Removes leading and trailing whitespace from str. Returns nil if str was not altered. str.sub(pattern, replacement) [or] str.sub(pattern) { |match| block } Returns a copy of str with the first occurrence of pattern replaced with either replacement or the value of the block. The pattern will typically be a Regexp; if it is a String then no regular expression metacharacters will be interpreted. str.sub!(pattern, replacement) [or] str.sub!(pattern) { |match| block } Performs the substitutions of String#sub in place, returning str, or nil if no substitutions were performed. str.succ [or] str.next Returns the successor to str. str.succ! [or] str.next! Equivalent to String#succ, but modifies the receiver in place. str.sum(n=16) Returns a basic n-bit checksum of the characters in str, where n is the optional Fixnum parameter, defaulting to 16. The result is simply the sum of the binary value of each
58
59
60
61
62
63
64
65
character in str modulo 2n - 1. This is not a particularly good checksum. 66 str.swapcase Returns a copy of str with uppercase alphabetic characters converted to lowercase and lowercase characters converted to uppercase. str.swapcase! Equivalent to String#swapcase, but modifies the receiver in place, returning str, or nil if no changes were made. str.to_f Returns the result of interpreting leading characters in str as a floating-point number. Extraneous characters past the end of a valid number are ignored. If there is not a valid number at the start of str, 0.0 is returned. This method never raises an exception. str.to_i(base=10) Returns the result of interpreting leading characters in str as an integer base (base 2, 8, 10, or 16). Extraneous characters past the end of a valid number are ignored. If there is not a valid number at the start of str, 0 is returned. This method never raises an exception. str.to_s [or] str.to_str Returns the receiver. str.tr(from_str, to_str) Returns a copy of str with the characters in from_str replaced by the corresponding characters in to_str. If to_str is shorter than from_str, it is padded with its last character. Both strings may use the c1.c2 notation to denote ranges of characters, and from_str may start with a ^, which denotes all characters except those listed. str.tr!(from_str, to_str) Translates str in place, using the same rules as String#tr. Returns str, or nil if no changes were made. str.tr_s(from_str, to_str) Processes a copy of str as described under String#tr, then removes duplicate characters in regions that were affected by the translation. str.tr_s!(from_str, to_str) Performs String#tr_s processing on str in place, returning str, or nil if no changes were made. str.unpack(format) Decodes str (which may contain binary data) according to the format string, returning an array of each value extracted. The format string consists of a sequence of singlecharacter directives, summarized in Table 18. Each directive may be followed by a number, indicating the number of times to repeat with this directive. An asterisk (*) will use up all remaining elements. The directives sSiIlL may each be followed by an
67
68
69
70
71
72
73
74
75
underscore (_) to use the underlying platform's native size for the specified type; otherwise, it uses a platform-independent consistent size. Spaces are ignored in the format string. 76 str.upcase Returns a copy of str with all lowercase letters replaced with their uppercase counterparts. The operation is locale insensitive.only characters a to z are affected. str.upcase! Changes the contents of str to uppercase, returning nil if no changes are made. str.upto(other_str) { |s| block } Iterates through successive values, starting at str and ending at other_str inclusive, passing each value in turn to the block. The String#succ method is used to generate each value.
77
78
String unpack directives:

Following table lists unpack directives for method String#unpack. Directive A a B b C c D, d E Returns String String String String Fixnum Fixnum Float Float Description With trailing nulls and spaces removed. String. Extract bits from each character (most significant bit first). Extract bits from each character (least significant bit first). Extract a character as an unsigned integer. Extract a character as an integer. Treat sizeof(double) characters as a native double. Treat sizeof(double) characters as a double in littleendian byte order. Treat sizeof(float) characters as a float in littleendian byte order. Treat sizeof(float) characters as a native float.
Float
F, f
Float
Float
Treat sizeof(double) characters as a double in network byte order. Treat sizeof(float) characters as a float in network byte order. Extract hex nibbles from each character (most significant bit first) Extract hex nibbles from each character (least significant bit first). Treat sizeof(int) (modified by _) successive characters as an unsigned native integer. Treat sizeof(int) (modified by _) successive characters as a signed native integer. Treat four (modified by _) successive characters as an unsigned native long integer. Treat four (modified by _) successive characters as a signed native long integer. Quoted-printable. Base64-encoded. Treat four characters as an unsigned long in network byte order. Treat two characters as an unsigned short in network byte order. Treat sizeof(char *) characters as a pointer, and return \emph{len} characters from the referenced location. Treat sizeof(char *) characters as a pointer to a nullterminated string. Treat eight characters as an unsigned quad word (64 bits). Treat eight characters as a signed quad word (64 bits).
String
String
String
Integer
Integer
Integer
Integer
M m N
String String Integer
Fixnum
String
String
Q q
Integer Integer
Fixnum
Treat two (different if _ used) successive characters as an unsigned short in native byte order. Treat two (different if _ used) successive characters as a signed short in native byte order. UTF-8 characters as unsigned integers. UU-encoded. Treat four characters as an unsigned long in little-endian byte order. Treat two characters as an unsigned short in little-endian byte order. BER-compressed integer. Skip backward one character. Skip forward one character.
Fixnum
U u V
Integer String Fixnum
Fixnum
w X x Z @
Integer
String
With trailing nulls removed up to first null with *. Skip to the offset given by the length argument.
Example:
Try following example to unpack various data.
"abc \0\0abc \0\0".unpack('A6Z6') "abc \0\0".unpack('a3a3') "abc \0abc \0".unpack('Z*Z*') "aa".unpack('b8B8') "aaa".unpack('h2H2c') "\xfe\xff\xfe\xff".unpack('sS') "now=20is".unpack('M*') "whole".unpack('xax2aX2aX1aX2a')
#=> #=> #=> #=> #=> #=> #=> #=>
["abc", "abc "] ["abc", " \000\000"] ["abc ", "abc "] ["10000110", "01100001"] ["16", "61", 97] [-2, 65534] ["now is"] ["h", "e", "l", "l", "o"]
Ruby arrays are ordered, integer-indexed collections of any object. Each element in an array is associated with and referred to by an index. Array indexing starts at 0, as in C or Java. A negative index is assumed relative to the end of the array--that is, an index of -1 indicates the last element of the array, -2 is the next to last element in the array, and so on.
Ruby arrays can hold objects such as String, Integer, Fixnum, Hash, Symbol, even other Array objects. Ruby arrays are not as rigid as arrays in other languages. Ruby arrays grow automatically while adding elements to them.
Creating Arrays:
There are many ways to create or initialize an array. One way is with the new class method:
names = Array.new
You can set the size of an array at the time of creating array:
names = Array.new(20)
The array names now has a size or length of 20 elements. You can return the size of an array with either the size or length methods:
months.size # This returns 20 months.length # This also returns 20

You can assign a value to each element in the array as follows:
#!/usr/bin/ruby names = Array.new(4, "mac") puts "#{names}"

macmacmacmac
You can also use a block with new, populating each element with what the block evaluates to:
#!/usr/bin/ruby nums = Array.new(10) { |e| e = e * 2 } puts "#{nums}"

024681012141618
There is another method of Array, []. It works like this:
nums = Array.[](1, 2, 3, 4,5)

One more form of array creation is as follows :
nums = Array[1, 2, 3, 4,5]

The Kernel module available in core Ruby, has an Array method, which only accepts a single argument. Here the method takes a range as an argument to create an array of digits:
#!/usr/bin/ruby digits = Array(0..9) puts "#{digits}"

0123456789
Array Built-in Methods:

We need to have an instance of Array object to call a Array method. As we have seen, following is the way to create an instance of Array object:
Array.[](...) [or] Array[...] [or] [...]

This will returns a new array populated with the given objects. Now using created object we can call any available instance methods. For example:
#!/usr/bin/ruby digits = Array(0..9) num = digits.at(6) puts "#{num}"

6
Following are the public array methods ( Assuming array is an array object ): SN 1 Methods with Description array & other_array Returns a new array containing elements common to the two arrays, with no duplicates. array * int [or] array * str Returns a new array built by concatenating the int copies of self. With a String argument, equivalent to self.join(str).
array + other_array Returns a new array built by concatenating the two arrays together to produce a third array. array . other_array Returns a new array that is a copy of the original array, removing any items that also appear in other_array. str <=> other_str Compares str with other_str, returning -1 (less than), 0 (equal), or 1 (greater than). The comparison is casesensitive. array | other_array Returns a new array by joining array with other_array, removing duplicates. array << obj Pushes the given object onto the end of array. This expression returns the array itself, so several appends may be chained together. array <=> other_array Returns an integer (-1, 0, or +1) if this array is less than, equal to, or greater than other_array. array == other_array Two arrays are equal if they contain the same number of elements and if each element is equal to (according to Object.==) the corresponding element in the other array. array[index] [or] array[start, length] [or] array[range] [or] array.slice(index) [or] array.slice(start, length) [or] array.slice(range) Returns the element at index, or returns a subarray starting at start and continuing forlength elements, or returns a subarray specified by range. Negative indices count backward from the end of the array (-1 is the last element). Returns nil if the index (or starting index) is out of range. array[index] = obj [or] array[start, length] = obj or an_array or nil [or] array[range] = obj or an_array or nil Sets the element at index, or replaces a subarray starting at start and continuing forlength elements, or replaces a subarray specified by range. If indices are greater than the current capacity of the array, the array grows automatically. Negative indices will count backward from the end of the array. Inserts elements if length is zero. If nil is used in the second and third form, deletes elements from self. array.abbrev(pattern = nil) Calculates the set of unambiguous abbreviations for the strings in self. If passed a pattern or a string, only the strings matching the pattern or starting with the string are considered.
10
11
12
13
array.assoc(obj) Searches through an array whose elements are also arrays comparing obj with the first element of each contained array using obj.==. Returns the first contained array that matches , or nil if no match is found. array.at(index) Returns the element at index. A negative index counts from the end of self. Returns nil if the index is out of range. array.clear Removes all elements from array. array.collect { |item| block } [or] array.map { |item| block } Invokes block once for each element of self. Creates a new array containing the values returned by the block. array.collect! { |item| block } [or] array.map! { |item| block } Invokes block once for each element of self, replacing the element with the value returned by block. array.compact Returns a copy of self with all nil elements removed. array.compact! Removes nil elements from array. Returns nil if no changes were made. array.concat(other_array) Appends the elements in other_array to self. array.delete(obj) [or] array.delete(obj) { block } Deletes items from self that are equal to obj. If the item is not found, returns nil. If the optional code block is given, returns the result of block if the item is not found. array.delete_at(index) Deletes the element at the specified index, returning that element, or nil if the index is out of range. array.delete_if { |item| block } Deletes every element of self for which block evaluates to true. array.each { |item| block } Calls block once for each element in self, passing that element as a parameter.
14
15
16
17
18
19
20
21
22
23
24
25
array.each_index { |index| block } Same as Array#each, but passes the index of the element instead of the element itself. array.empty? Returns true if the self array contains no elements. array.eql?(other) Returns true if array and other are the same object, or are both arrays with the same content. array.fetch(index) [or] array.fetch(index, default) [or] array.fetch(index) { |index| block } Tries to return the element at position index. If index lies outside the array, the first form throws an IndexError exception, the second form returns default, and the third form returns the value of invoking block, passing in index. Negative values of index count from the end of the array. array.fill(obj) [or] array.fill(obj, start [, length]) [or] array.fill(obj, range) [or] array.fill { |index| block } [or] array.fill(start [, length] ) { |index| block } [or] array.fill(range) { |index| block } The first three forms set the selected elements of self to obj. A start of nil is equivalent to zero. A length of nil is equivalent to self.length. The last three forms fill the array with the value of the block. The block is passed the absolute index of each element to be filled. array.first [or] array.first(n) Returns the first element, or the first n elements, of the array. If the array is empty, the first form returns nil, and the second form returns an empty array. array.flatten Returns a new array that is a one-dimensional flattening of this array (recursively). array.flatten! Flattens array in place. Returns nil if no modifications were made. (array contains no subarrays.) array.frozen? Returns true if array is frozen (or temporarily frozen while being sorted). array.hash Compute a hash-code for array. Two arrays with the same content will have the same hash code
26
27
28
29
30
31
32
33
34
35
array.include?(obj) Returns true if obj is present in self, false otherwise. array.index(obj) Returns the index of the first object in self that is == to obj. Returns nil if no match is found. array.indexes(i1, i2, ... iN) [or] array.indices(i1, i2, ... iN) This methods is deprecated in latest version of Ruby so please use Array#values_at. array.indices(i1, i2, ... iN) [or] array.indexes(i1, i2, ... iN) This methods is deprecated in latest version of Ruby so please use Array#values_at. array.insert(index, obj...) Inserts the given values before the element with the given index (which may be negative). array.inspect Creates a printable version of array. array.join(sep=$,) Returns a string created by converting each element of the array to a string, separated bysep. array.last [or] array.last(n) Returns the last element(s) of self. If array is empty, the first form returns nil. array.length Returns the number of elements in self. May be zero. array.map { |item| block } [or] array.collect { |item| block } Invokes block once for each element of self. Creates a new array containing the values returned by the block. array.map! { |item| block } [or] array.collect! { |item| block } Invokes block once for each element of array, replacing the element with the value returned by block. array.nitems Returns the number of non-nil elements in self. May be zero. array.pack(aTemplateString) Packs the contents of array into a binary sequence according to the directives in
36
37
38
39
40
41
42
43
44
45
46
47
aTemplateString. Directives A, a, and Z may be followed by a count, which gives the width of the resulting field. The remaining directives also may take a count, indicating the number of array elements to convert. If the count is an asterisk (*), all remaining array elements will be converted. Any of the directives sSiIlL may be followed by an underscore (_) to use the underlying platform's native size for the specified type; otherwise, they use a platformindependent size. Spaces are ignored in the template string. ( See templating Table below ) 48 array.pop Removes the last element from array and returns it, or nil if array is empty. array.push(obj, ...) Pushes (appends) the given obj onto the end of this array. This expression returns the array itself, so several appends may be chained together. array.rassoc(key) Searches through the array whose elements are also arrays. Compares key with the second element of each contained array using ==. Returns the first contained array that matches. array.reject { |item| block } Returns a new array containing the items array for which the block is not true. array.reject! { |item| block } Deletes elements from array for which the block evaluates to true, but returns nil if no changes were made. Equivalent to Array#delete_if. array.replace(other_array) Replaces the contents of array with the contents of other_array, truncating or expanding if necessary. array.reverse Returns a new array containing array's elements in reverse order. array.reverse! Reverses array in place. array.reverse_each {|item| block } Same as Array#each, but traverses array in reverse order. array.rindex(obj) Returns the index of the last object in array == to obj. Returns nil if no match is found. array.select {|item| block } Invokes the block passing in successive elements from array, returning an array containing those elements for which the block returns a true value.
49
50
51
52
53
54
55
56
57
58
59
array.shift Returns the first element of self and removes it (shifting all other elements down by one). Returns nil if the array is empty. array.size Returns the length of array (number of elements). Alias for length. array.slice(index) [or] array.slice(start, length) [or] array.slice(range) [or] array[index] [or] array[start, length] [or] array[range] Returns the element at index, or returns a subarray starting at start and continuing forlength elements, or returns a subarray specified by range. Negative indices count backward from the end of the array (-1 is the last element). Returns nil if the index (or starting index) are out of range. array.slice!(index) [or] array.slice!(start, length) [or] array.slice!(range) Deletes the element(s) given by an index (optionally with a length) or by a range. Returns the deleted object, subarray, or nil if index is out of range. array.sort [or] array.sort { | a,b | block } Returns a new array created by sorting self. array.sort! [or] array.sort! { | a,b | block } Sorts self. array.to_a Returns self. If called on a subclass of Array, converts the receiver to an Array object. array.to_ary Returns self. array.to_s Returns self.join. array.transpose Assumes that self is an array of arrays and transposes the rows and columns. array.uniq Returns a new array by removing duplicate values in array. array.uniq! Removes duplicate elements from self. Returns nil if no changes are made (that is, no duplicates are found). array.unshift(obj, ...)
60
61
62
63
64
65
66
67
68
69
70
71
Prepends objects to the front of array, other elements up one. 72 array.values_at(selector,...) Returns an array containing the elements in self corresponding to the given selector (one or more). The selectors may be either integer indices or ranges. array.zip(arg, ...) [or] array.zip(arg, ...){ | arr | block } Converts any arguments to arrays, then merges elements of array with corresponding elements from each argument.
73
Array pack directives:

Following table lists pack directives for use with Array#pack. Directive @ A a B b C c D, d E e F, f G g Moves to absolute position. ASCII string (space padded, count is width). ASCII string (null padded, count is width). Bit string (descending bit order). Bit string (ascending bit order). Unsigned char. Char. Double-precision float, native format. Double-precision float, little-endian byte order. Single-precision float, little-endian byte order. Single-precision float, native format. Double-precision float, network (big-endian) byte order. Single-precision float, network (big-endian) byte order. Description
H h I i L l M m N n P p Q, q S s U u V v w X
Hex string (high nibble first). Hex string (low nibble first). Unsigned integer. Integer. Unsigned long. Long. Quoted printable, MIME encoding (see RFC 2045). Base64-encoded string. Long, network (big-endian) byte order. Short, network (big-endian) byte order. Pointer to a structure (fixed-length string). Pointer to a null-terminated string. 64-bit number. Unsigned short. Short. UTF-8. UU-encoded string. Long, little-endian byte order. Short, little-endian byte order. BER-compressed integer \fnm. Back up a byte.
x Z
Null byte. Same as a, except that null is added with *.
Example:
Try following example to pack various data.
a = [ "a", "b", "c" ] n = [ 65, 66, 67 ] a.pack("A3A3A3") #=> "a b c " a.pack("a3a3a3") #=> "a\000\000b\000\000c\000\000" n.pack("ccc") #=> "ABC"
A Hash is a collection of key-value pairs like this: "employee" => "salary". It is similar to an Array, except that indexing is done via arbitrary keys of any object type, not an integer index. The order in which you traverse a hash by either key or value may seem arbitrary, and will generally not be in the insertion order. If you attempt to access a hash with a key that does not exist, the method will return nil
Creating Hashes:
As with arrays, there is a variety of ways to create hashes. You can create an empty hash with the new class method:
months = Hash.new
You can also use new to create a hash with a default value, which is otherwise just nil:
months = Hash.new( "month" ) or months = Hash.new "month"

When you access any key in a hash that has a default value, if the key or value doesn't exist, accessing the hash will return the default value:
#!/usr/bin/ruby months = Hash.new( "month" ) puts "#{months[0]}" puts "#{months[72]}"

month month
Here is a simple way of creating and accessing Hash keys/values:
#!/usr/bin/ruby H = Hash["a" => 100, "b" => 200] puts "#{H['a']}" puts "#{H['b']}"
100 200
You can use any Ruby object as a key or value, even an array, so following example is a valid one:
[1,"jan"] => "January"
Hash Built-in Methods:

We need to have an instance of Hash object to call a Hash method. As we have seen, following is the way to create an instance of Hash object:
Hash[[key =>|, value]* ] or Hash.new [or] Hash.new(obj) [or] Hash.new { |hash, key| block }
This will returns a new hash populated with the given objects. Now using created object we can call any available instance methods. For example:
#!/usr/bin/ruby $, = ", " months = Hash.new( "month" ) months = {"1" => "January", "2" => "February"} keys = months.keys puts "#{keys}"
1, 2
Following are the public hash methods ( Assuming hash is an array object ):
SN 1
Methods with Description hash == other_hash Tests whether two hashes are equal, based on whether they have the same number of key-value pairs, and whether the key-value pairs match the corresponding pair in each hash. hash.[key] Using a key, references a value from hash. If the key is not found, returns a default value. hash.[key]=value Associates the value given by value with the key given by key. hash.clear Removes all key-value pairs from hash. hash.default(key = nil) Returns the default value for hash, nil if not set by default=. ([] returns a default value if the key does not exist in hash.) hash.default = obj Sets a default value for hash. hash.default_proc Returns a block if hash was created by a block. hash.delete(key) [or] array.delete(key) { |key| block } Deletes a key-value pair from hash by key. If block is used, returns the result of a block if pair is not found. Compare delete_if. hash.delete_if { |key,value| block } Deletes a key-value pair from hash for every pair the block evaluates to true. hash.each { |key,value| block } Iterates over hash, calling the block once for each key, passing the key-value as a twoelement array. hash.each_key { |key| block } Iterates over hash, calling the block once for each key, passing key as a parameter. hash.each_key { |key_value_array| block } Iterates over hash, calling the block once for each key, passing the key and value as parameters.
10
11
12
13
hash.each_key { |value| block } Iterates over hash, calling the block once for each key, passing value as a parameter. hash.empty? Tests whether hash is empty (contains no key-value pairs), returning true or false. hash.fetch(key [, default] ) [or] hash.fetch(key) { | key | block } Returns a value from hash for the given key. If the key can't be found, and there are no other arguments, it raises an IndexError exception; if default is given, it is returned; if the optional block is specified, its result is returned. hash.has_key?(key) [or] hash.include?(key) [or] hash.key?(key) [or] hash.member?(key) Tests whether a given key is present in hash, returning true or false. hash.has_value?(value) Tests whether hash contains the given value. hash.index(value) Returns the key for the given value in hash, nil if no matching value is found. hash.indexes(keys) Returns a new array consisting of values for the given key(s). Will insert the default value for keys that are not found. This method is deprecated. Use select. hash.indices(keys) Returns a new array consisting of values for the given key(s). Will insert the default value for keys that are not found. This method is deprecated. Use select. hash.inspect Returns a pretty print string version of hash. hash.invert Creates a new hash, inverting keys and values from hash; that is, in the new hash, the keys from hash become values, and values become keys. hash.keys Creates a new array with keys from hash. hash.length Returns the size or length of hash as an integer. hash.merge(other_hash) [or] hash.merge(other_hash) { |key, oldval, newval| block } Returns a new hash containing the contents of hash and other_hash, overwriting pairs in
14
15
16
17
18
19
20
21
22
23
24
25
hash with duplicate keys with those from other_hash. 26 hash.merge!(other_hash) [or] hash.merge!(other_hash) { |key, oldval, newval| block } Same as merge, but changes are done in place. hash.rehash Rebuilds hash based on the current values for each key. If values have changed since they were inserted, this method reindexes hash. hash.reject { |key, value| block } Creates a new hash for every pair the block evaluates to true hash.reject! { |key, value| block } Same as reject, but changes are made in place. hash.replace(other_hash) Replaces the contents of hash with the contents of other_ hash. hash.select { |key, value| block } Returns a new array consisting of key-value pairs from hash for which the block returnstrue. hash.shift Removes a key-value pair from hash, returning it as a two-element array. hash.size Returns the size or length of hash as an integer. hash.sort Converts hash to a two-dimensional array containing arrays of key-value pairs, then sorts it as an array. hash.store(key, value) Stores a key-value pair in hash. hash.to_a Creates a two-dimensional array from hash. Each key/value pair is converted to an array, and all these arrays are stored in a containing array. hash.to_hash Returns hash (self). hash.to_s Converts hash to an array, then converts that array to a string.
27
28
29
30
31
32
33
34
35
36
37
38
39
hash.update(other_hash) [or] hash.update(other_hash) {|key, oldval, newval| block} Returns a new hash containing the contents of hash and other_hash, overwriting pairs inhash with duplicate keys with those from other_hash. hash.value?(value) Tests whether hash contains the given value. hash.values Returns a new array containing all the values of hash. hash.values_at(obj, ...) Returns a new array containing the values from hash that are associated with the given key or keys.
40
41
42
The Time class represents dates and times in Ruby. It is a thin layer over the system date and time functionality provided by the operating system. This class may be unable on your system to represent dates before 1970 or after 2038. This tutorial will make you familiar with all the most wanted concepts of date and time.
Getting Current Date and Time:

Following is the simple example to get current date and time:
#!/usr/bin/ruby -w time1 = Time.new puts "Current Time : " + time1.inspect # Time.now is a synonym: time2 = Time.now puts "Current Time : " + time2.inspect
Current Time : Mon Jun 02 12:02:39 -0700 2008 Current Time : Mon Jun 02 12:02:39 -0700 2008
Getting components of a Date & Time:

We can use Time object to get various components of date and time. Following is the example showing the same:
#!/usr/bin/ruby -w time = Time.new
# Components of a Time puts "Current Time : " puts time.year # => puts time.month # => puts time.day # => puts time.wday # => puts time.yday # => puts time.hour # => puts time.min # => puts time.sec # => puts time.usec # => puts time.zone # =>
+ time.inspect Year of the date Month of the date (1 to 12) Day of the date (1 to 31 ) 0: Day of week: 0 is Sunday 365: Day of year 23: 24-hour clock 59 59 999999: microseconds "UTC": timezone name
Current Time : Mon Jun 02 12:03:08 -0700 2008 2008 6 2 1 154 12 3 8 247476 UTC
Time.utc, Time.gm and Time.local Functions:

These two functions can be used to format date in standard format as follows:
# July 8, 2008 Time.local(2008, 7, 8) # July 8, 2008, 09:10am, local time Time.local(2008, 7, 8, 9, 10) # July 8, 2008, 09:10 UTC Time.utc(2008, 7, 8, 9, 10) # July 8, 2008, 09:10:11 GMT (same as UTC) Time.gm(2008, 7, 8, 9, 10, 11)
Following is the example to get all components in an array in the following format:
[sec,min,hour,day,month,year,wday,yday,isdst,zone]
Try the following:
#!/usr/bin/ruby -w time = Time.new values = t.to_a p values

This will generate following result:
[26, 10, 12, 2, 6, 2008, 1, 154, false, "MST"]

This array could be passed to Time.utc or Time.local functions to get different format of dates as follows:
#!/usr/bin/ruby -w time = Time.new values = t.to_a puts Time.utc(*values)

This will generate following result:
Mon Jun 02 12:15:36 UTC 2008

Followin is the way to get time represented internally as seconds since the (platform-dependent) epoch:
# Returns number of seconds since epoch time = Time.now.to_i # Convert number of seconds into Time object. Time.at(time) # Returns second since epoch which includes microseconds time = Time.now.to_f
Timezones and daylight savings time:

You can use a Time object to get all the information related to Timezones and daylight savings as follows:
time = Time.new # Here is the interpretation time.zone # => "UTC": return the timezone time.utc_offset # => 0: UTC is 0 seconds offset from UTC time.zone # => "PST" (or whatever your timezone is) time.isdst # => false: If UTC does not have DST. time.utc? # => true: if t is in UTC time zone time.localtime # Convert to local timezone. time.gmtime # Convert back to UTC. time.getlocal # Return a new Time object in local zone time.getutc # Return a new Time object in UTC
Formatting Times and Dates:

There are various ways to format date and time. Here is one example showing few:
#!/usr/bin/ruby -w time = Time.new puts time.to_s puts time.ctime puts time.localtime
puts time.strftime("%Y-%m-%d %H:%M:%S")

Mon Jun 02 Mon Jun 2 Mon Jun 02 2008-06-02
12:35:19 -0700 2008 12:35:19 2008 12:35:19 -0700 2008 12:35:19
Time Formatting Directives:

These directives in the following table are used with the method Time.strftime. Directive %a %A %b %B %c %d %H %I %j %m %M %p %S %U Description The abbreviated weekday name (Sun). The full weekday name (Sunday). The abbreviated month name (Jan). The full month name (January). The preferred local date and time representation. Day of the month (01 to 31). Hour of the day, 24-hour clock (00 to 23). Hour of the day, 12-hour clock (01 to 12). Day of the year (001 to 366). Month of the year (01 to 12). Minute of the hour (00 to 59). Meridian indicator (AM or PM). Second of the minute (00 to 60). Week number of the current year, starting with the first Sunday as the first day of the first week (00 to 53).
%W
Week number of the current year, starting with the first Monday as the first day of the first week (00 to 53). Day of the week (Sunday is 0, 0 to 6). Preferred representation for the date alone, no time. Preferred representation for the time alone, no date. Year without a century (00 to 99). Year with century. Time zone name. Literal % character.
%w %x %X %y %Y %Z %%
Time arithmetic:
You can do simple arithmetic with time as follows:
now = Time.now past = now - 10 future = now + 10 future - now
# # # #
Current time 10 seconds ago. Time - number => Time 10 seconds from now Time + number => Time => 10 Time - Time => number of seconds
****************************************************************************** ******
Ranges occur everywhere: January to December, 0 to 9, lines 50 through 67, and so on. Ruby supports ranges and allows us to use ranges in a variety of ways:
Ranges as Sequences Ranges as Conditions Ranges as Intervals
Ranges as Sequences:
The first and perhaps most natural use of ranges is to express a sequence. Sequences have a start point, an end point, and a way to produce successive values in the sequence. Ruby creates these sequences using the ''..'' and ''...'' range operators. The two-dot form creates an inclusive range, while the three-dot form creates a range that excludes the specified high value.
(1..5) (1...5) ('a'..'d')
#==> 1, 2, 3, 4, 5 #==> 1, 2, 3, 4 #==> 'a', 'b', 'c', 'd'
The sequence 1..100 is held as a Range object containing references to two Fixnum objects. If you need to, you can convert a range to a list using the to_a method. Try following example:
#!/usr/bin/ruby $, =", " # Array value separator range1 = (1..10).to_a range2 = ('bar'..'bat').to_a puts "#{range1}" puts "#{range2}"
1, 2, 3, 4, 5, 6, 7, 8, 9, 10 bar, bas, bat

Ranges implement methods that let you iterate over them and test their contents in a variety of ways:
#!/usr/bin/ruby # Assume a range digits = 0..9 puts digits.include?(5) ret = digits.min puts "Min value is #{ret}" ret = digits.max puts "Max value is #{ret}" ret = digits.reject {|i| i < 5 } puts "Rejected values are #{ret}" digits.each do |digit| puts "In Loop #{digit}" end
true Min value is 0 Max value is 9 Rejected values are 5, 6, 7, 8, 9 In Loop 0 In Loop 1 In Loop 2 In Loop 3 In Loop 4 In Loop 5 In Loop 6 In Loop 7 In Loop 8 In Loop 9
Ranges as Conditions:
Ranges may also be used as conditional expressions. For example, the following code fragment prints sets of lines from standard input, where the first line in each set contains the word startand the last line the word end.:
while gets print if /start/../end/ end

Ranges can be used in case statements:
#!/usr/bin/ruby score = 70 result = case score when 0..40: "Fail" when 41..60: "Pass" when 61..70: "Pass with Merit" when 71..100: "Pass with Distinction" else "Invalid Score" end puts result
Pass with Merit
Ranges as Intervals:
A final use of the versatile range is as an interval test: seeing if some value falls within the interval represented by the range. This is done using ===, the case equality operator.
#!/usr/bin/ruby if ((1..10) === 5) puts "5 lies in (1..10)" end if (('a'..'j') === 'c') puts "c lies in ('a'..'j')" end if (('a'..'j') === 'z') puts "z lies in ('a'..'j')" end
5 lies in (1..10) c lies in ('a'..'j')
Iterators are nothing but methods supported by collections. Objects that store a group of data members are called collections. In Ruby, arrays and hashes can be termed collections. Iterators return all the elements of a collection, one after the other. We will be discussing two iterators here, each and collect. Let's look at these in detail.
Ruby each Iterator:

The each iterator returns all the elements of an array or a hash.
Syntax:
collection.each do |variable| code end
Executes code for each element in collection. Here collection could be an array or a ruby hash.
Example:
#!/usr/bin/ruby ary = [1,2,3,4,5] ary.each do |i| puts i end
1 2 3 4 5
You always associate the each iterator with a block. It returns each value of the array, one by one, to the block. The value is stored in the variable i and then displayed on the screen.
Ruby collect Iterator:

The collect iterator returns all the elements of a collection.
Syntax:
collection = collection.collect
The collect method need not always be associated with a block. The collect method returns the entire collection, regardless of whether it is an array or a hash.
Example:
#!/usr/bin/ruby a = [1,2,3,4,5] b = Array.new b = a.collect puts b
1 2 3 4 5
NOTE: The collect method is not the right way to do copying between arrays. There is another method called a clone which should be used to copy one array into another array. You normally use the collect method when you want to do something with each of the values to get the new array. For example, this code produces an array b containing 10 times each value in a.
#!/usr/bin/ruby a = [1,2,3,4,5] b = a.collect{|x| 10*x} puts b

10 20 30 40 50
Ruby provides a whole set of I/O-related methods implemented in the Kernel module. All the I/O methods are derived from the class IO. The class IO provides all the basic methods, such as read, write, gets, puts, readline, getc, andprintf. This chapter will cover all ithe basic I/O functions available in Ruby. For more functions please refere to Ruby Class IO.
The puts Statement:

In previous chapters, you assigned values to variables and then printed the output using putsstatement.
The puts statement instructs the program to display the value stored in the variable. This will add a new line at the end of each line it writes.
Example:
#!/usr/bin/ruby val1 val2 puts puts = "This is variable one" = "This is variable two" val1 val2
This is variable one This is variable two
The gets Statement:

The gets statement can be used to take any input from the user from standard screen called STDIN.
Example:
The following code shows you how to use the gets statement. This code will prompt the user to enter a value, which will be stored in a variable val and finally will be printed on STDOUT.
#!/usr/bin/ruby puts "Enter a value :" val = gets puts val

Enter a value : This is entered value This is entered value
The putc Statement:

Unlike the puts statement, which outputs the entire string onto the screen, the putc statement can be used to output one character at a time.
Example:
The output of the following code is just the character H:
#!/usr/bin/ruby str="Hello Ruby!"
putc str
The print Statement:

The print statement is similar to the puts statement. The only difference is that the putsstatement goes to the next line after printing the contents, whereas with the print statement the cursor is positioned on the same line.
Example:
#!/usr/bin/ruby print "Hello World" print "Good Morning"
Hello WorldGood Morning
Opening and Closing Files:

Until now, you have been reading and writing to the standard input and output. Now we will see how to play with actual data files.
The File.new Method:

You can create a File object using File.new method for reading, writing, or both, according to the mode string. Finally you can use File.close method to close that file.
Syntax:
aFile = File.new("filename", "mode") # ... process the file aFile.close
The File.open Method:

You can use File.open method to create a new file object and assign that file object to a file. However, there is one difference in between File.open and File.new methods. The difference is that the File.open method can be associated with a block, whereas you cannot do the same using the File.new method.
File.open("filename", "mode") do |aFile| # ... process the file end

Here is a list of The Different Modes of Opening a File:
Modes r
Description Read-only mode. The file pointer is placed at the beginning of the file. This is the default mode. Read-write mode. The file pointer will be at the beginning of the file. Write-only mode. Overwrites the file if the file exists. If the file does not exist, creates a new file for writing. Read-write mode. Overwrites the existing file if the file exists. If the file does not exist, creates a new file for reading and writing. Write-only mode. The file pointer is at the end of the file if the file exists. That is, the file is in the append mode. If the file does not exist, it creates a new file for writing. Read and write mode. The file pointer is at the end of the file if the file exists. The file opens in the append mode. If the file does not exist, it creates a new file for reading and writing.
r+ w
w+
a+
Reading and Writing Files:

The same methods that we've been using for 'simple' I/O are available for all file objects. So, gets reads a line from standard input, and aFile.gets reads a line from the file object aFile. However, I/O objects provides additional set of access methods to make our lives easier.
The sysread Method:

You can use the method sysread to read the contents of a file. You can open the file in any of the modes when using the method sysread. For example :
#!/usr/bin/ruby aFile = File.new("/var/www/tutorialspoint/ruby/test", "r") if aFile content = aFile.sysread(20) puts content else puts "Unable to open file!" end
This statement will output the first 20 characters of the file. The file pointer will now be placed at the 21st character in the file.
The syswrite Method:

You can use the method syswrite to write the contents into a file. You need to open the file in write mode when using the method syswrite. For example :
#!/usr/bin/ruby aFile = File.new("/var/www/tutorialspoint/ruby/test", "r+") if aFile aFile.syswrite("ABCDEF") else puts "Unable to open file!" end
This statement will write "ABCDEF" into the file.
The each_byte Method:

This method belongs to the class File. The method each_byte is always associated with a block. Consider the following code sample: :
#!/usr/bin/ruby aFile = File.new("/var/www/tutorialspoint/ruby/test", "r") if aFile aFile.syswrite("ABCDEF") aFile.each_byte {|ch| putc ch; putc ?. } else puts "Unable to open file!" end
Characters are passed one by one to the variable ch and then displayed on the screen as follows:
T.h.i.s. .i.s. .l.i.n.e. .o.n.e. .T.h.i.s. .i.s. .l.i.n.e. .t.w.o. .T.h.i.s. .i.s. .l.i.n.e. .t.h.r.e.e. .A.n.d. .s.o. .o.n.......
The IO.readlines Method:

The class File is a subclass of the class IO. The class IO also has some methods which can be used to manipulate files. One of the IO class methods is IO.readlines. This method returns the contents of the file line by line. The following code displays the use of the method IO.readlines:
#!/usr/bin/ruby arr = IO.readlines("/var/www/tutorialspoint/ruby/test") puts arr[0] puts arr[1]
In this code, the variable arr is an array. Each line of the file test will be an element in the array arr. Therefore, arr[0] will contain the first line, whereas arr[1] will contain the second line of the file.
The IO.foreach Method:

This method also returns output line by line. The difference between the method foreach and the method readlines is that the method foreach is associated with a block. However, unlike the method readlines, the method foreach does not return an array. For example:
#!/usr/bin/ruby IO.foreach("test"){|block| puts block}

This code will pass the contents of the file test line by line to the variable block, and then the output will be displayed on the screen.
Renaming and Deleting Files:

You can rename and delete files programmatically with Ruby with the rename and deletemethods. Following is the example to rename an existing file test1.txt:
#!/usr/bin/ruby # Rename a file from test1.txt to test2.txt File.rename( "test1.txt", "test2.txt" )
Following is the example to delete an existing file test2.txt:
#!/usr/bin/ruby # Delete file test2.txt File.delete("text2.txt")
File Modes and Ownership:

Use the chmod method with a mask to change the mode or permissions/access list of a file: Following is the example to change mode of an existing file test.txt to a mask value:
#!/usr/bin/ruby file = File.new( "test.txt", "w" ) file.chmod( 0755 )
Following is the table which can help you to choose different mask for chmod method:
Mask 0700 0400 0200 0100 0070 0040 0020 0010 0007 0004 0002 0001 4000 2000 1000 rwx mask for owner r for owner w for owner x for owner rwx mask for group r for group w for group x for group rwx mask for other r for other w for other x for other Set user ID on execution Set group ID on execution
Description
Save swapped text, even after use
File Inquiries:
The following command tests whether a file exists before opening it:
#!/usr/bin/ruby File.open("file.rb") if File::exists?( "file.rb" )
The following command inquire whether the file is really a file:
#!/usr/bin/ruby # This returns either true or false File.file?( "text.txt" )
The following command finds out if it given file name is a directory:
#!/usr/bin/ruby # a directory File::directory?( "/usr/local/bin" ) # => true # a file File::directory?( "file.rb" ) # => false
The following command finds whether the file is readable, writable or executable:
#!/usr/bin/ruby File.readable?( "test.txt" ) # => true File.writable?( "test.txt" ) # => true File.executable?( "test.txt" ) # => false
The following command finds whether the file has zero size or not:
#!/usr/bin/ruby File.zero?( "test.txt" ) # => true
The following command returns size of the file :
#!/usr/bin/ruby File.size?( "text.txt" ) # => 1002
The following command can be used to find out a type of file :
#!/usr/bin/ruby File::ftype( "test.txt" ) # => file
The ftype method identifies the type of the file by returning one of the following: file, directory, characterSpecial, blockSpecial, fifo, link, socket, or unknown. The following command can be used to find when a file was created, modified, or last accessed :
#!/usr/bin/ruby File::ctime( "test.txt" ) # => Fri May 09 10:06:37 -0700 2008 File::mtime( "text.txt" ) # => Fri May 09 10:44:44 -0700 2008 File::atime( "text.txt" ) # => Fri May 09 10:45:01 -0700 2008
Directories in Ruby:
All files are contained within various directories, and Ruby has no problem handling these too. Whereas the File class handles files, directories are handled with the Dir class.
Navigating Through Directories:

To change directory within a Ruby program, use Dir.chdir as follows. This example changes the current directory to /usr/bin.
Dir.chdir("/usr/bin")
You can find out what the current directory is with Dir.pwd:
puts Dir.pwd # This will return something like /usr/bin

You can get a list of the files and directories within a specific directory using Dir.entries:
puts Dir.entries("/usr/bin").join(' ')

Dir.entries returns an array with all the entries within the specified directory. Dir.foreach provides the same feature:
Dir.foreach("/usr/bin") do |entry| puts entry end

An even more concise way of getting directory listings is by using Dir's class array method:
Dir["/usr/bin/*"]
Creating a Directory:
The Dir.mkdir can be used to create directories:
Dir.mkdir("mynewdir")
You can also set permissions on a new directory (not one that already exists) with mkdir: NOTE: The mask 755 sets permissions owner, group, world [anyone] to rwxr-xr-x where r = read, w = write, and x = execute.
Dir.mkdir( "mynewdir", 755 )
Deleting a Directory:
The Dir.delete can be used to delete a directory. The Dir.unlink and Dir.rmdir perform exactly the same function and are provided for convenience.
Dir.delete("testdir")
Creating Files & Temporary Directories:

Temporary files are those that might be created briefly during a program's execution but aren't a permanent store of information. Dir.tmpdir provides the path to the temporary directory on the current system, although the method is not available by default. To make Dir.tmpdir available it's necessary to use require 'tmpdir'. You can use Dir.tmpdir with File.join to create a platform-independent temporary file:
require 'tmpdir' tempfilename = File.join(Dir.tmpdir, "tingtong") tempfile = File.new(tempfilename, "w") tempfile.puts "This is a temporary file" tempfile.close File.delete(tempfilename)
This code creates a temporary file, writes data to it, and deletes it. Ruby's standard library also includes a library called Tempfile that can create temporary files for you:
require 'tempfile' f = Tempfile.new('tingtong') f.puts "Hello" puts f.path f.close
The execution and the exception always go together. If you are opening a file which does not exist then if you did not handle this situation properly then your program is considered to be of bad quality. The program stops if an exception occurs. So exceptions are used to handle various type of errors which may occur during a program execution and take appropriate action instead of halting program completely. Ruby provide a nice mechanism to handle exceptions. We enclose the code that could raise an exception in a begin/end block and use rescue clauses to tell Ruby the types of exceptions we want to handle.
Syntax :
begin # rescue OneTypeOfException # rescue AnotherTypeOfException # else # Other exceptions ensure # Always will be executed end
Everything from begin to rescue is protected. If an exception occurs during the execution of this block of code, control is passed to the block between rescue and end.
For each rescue clause in the begin block, Ruby compares the raised Exception against each of the parameters in turn. The match will succeed if the exception named in the rescue clause is the same as the type of the currently thrown exception, or is a superclass of that exception. In an event that an exception does not match any of the error types specified, we are allowed to use an else clause after all the rescue clauses.
Example:
#!/usr/bin/ruby begin file = open("/unexistant_file") if file puts "File opened successfully" end rescue file = STDIN end print file, "==", STDIN, "\n"
This will produce following result. You can see that STDIN is substituted to file because openfailed.
#<IO:0xb7d16f84>==#<IO:0xb7d16f84>
Using retry Statement:

You can capture an exception using rescue block and then use retry statement to execute beginblock from the beginning.
Syntax:
begin # Exceptions raised by this code will # be caught by the following rescue clause rescue # This block will capture all types of exceptions retry # This will move control to the beginning of begin end
Example:
#!/usr/bin/ruby begin file = open("/unexistant_file") if file puts "File opened successfully" end rescue fname = "existant_file" retry end
The following is the flow of the process:
an exception occurred at open went to rescue. fname was re-assigned by retry went to the beginning of the begin this time file opens successfully continued the essential process.
NOTE: Notice that if the file of re-substituted name does not exist this example code retries infinitely. Be careful if you use retry for an exception process.
Using raise Statement:

You can use raise statement to raise an exception. The following method raises an exception whenever it's called. It's second message will be printed. Program
Syntax:
raise OR raise "Error Message" OR raise ExceptionType, "Error Message" OR raise ExceptionType, "Error Message" condition
The first form simply reraises the current exception (or a RuntimeError if there is no current exception). This is used in exception handlers that need to intercept an exception before passing it on. The second form creates a new RuntimeError exception, setting its message to the given string. This exception is then raised up the call stack. The third form uses the first argument to create an exception and then sets the associated message to the second argument. The fourth form is similar to third form but you can add any conditional statement like unless to raise an exception.
Example:
#!/usr/bin/ruby begin puts 'I am before the raise.' raise 'An error has occurred.' puts 'I am after the raise.' rescue puts 'I am rescued.' end puts 'I am after the begin block.'
I am before the raise. I am rescued. I am after the begin block.

One more example showing usage of raise:
#!/usr/bin/ruby begin raise 'A test exception.' rescue Exception => e puts e.message puts e.backtrace.inspect end
A test exception. ["test.rb:4"]
Using ensure Statement:

Sometimes you need to guarantee that some processing is done at the end of a block of code, regardless of whether an exception was raised. For example, you may have a file open on entry to the block, and you need to make sure it gets closed as the block exits. The ensure clause does just this. ensure goes after the last rescue clause and contains a chunk of code that will always be executed as the block terminates. It doesn't matter if the block exits normally, if it raises and rescues an exception, or if it is terminated by an uncaught exception . the ensure block will get run.
Syntax:
begin #.. process #..raise exception rescue #.. handle error ensure #.. finally ensure execution #.. This will always execute. end
Example:
begin raise 'A test exception.' rescue Exception => e puts e.message puts e.backtrace.inspect ensure puts "Ensuring execution" end
A test exception. ["test.rb:4"] Ensuring execution
Using else Statement:

If the else clause is present, it goes after the rescue clauses and before any ensure. The body of an else clause is executed only if no exceptions are raised by the main body of code.
Syntax:
begin #.. process #..raise exception rescue # .. handle error else #.. executes if there is no exception ensure #.. finally ensure execution #.. This will always execute. end
Example:
begin # raise 'A test exception.' puts "I'm not raising exception" rescue Exception => e puts e.message puts e.backtrace.inspect else puts "Congratulations-- no errors!" ensure puts "Ensuring execution" end
I'm not raising exception Congratulations-- no errors! Ensuring execution

Raised error message can be captured using $! variable.
Catch and Throw:

While the exception mechanism of raise and rescue is great for abandoning execution when things go wrong, it's sometimes nice to be able to jump out of some deeply nested construct during normal processing. This is where catch and throw come in handy.
The catch defines a block that is labeled with the given name (which may be a Symbol or a String). The block is executed normally until a throw is encountered.
Syntax:
throw :lablename #.. this will not be executed catch :lablename do #.. matching catch will be executed after a throw is encountered. end OR throw :lablename condition #.. this will not be executed catch :lablename do #.. matching catch will be executed after a throw is encountered. end
Example:
The following example uses a throw to terminate interaction with the user if '!' is typed in response to any prompt.
def promptAndGet(prompt) print prompt res = readline.chomp throw :quitRequested if res == "!" return res end catch :quitRequested do name = promptAndGet("Name: ") age = promptAndGet("Age: ") sex = promptAndGet("Sex: ") # .. # process information end promptAndGet("Name:")
Name: Ruby on Rails Age: 3 Sex: ! Name:Just Ruby
Class Exception:
Ruby's standard classes and modules raise exceptions. All the exception classes form a hierarchy, with the class Exception at the top. The next level contains seven different types:
Interrupt NoMemoryError SignalException ScriptError
StandardError SystemExit
There is one other exception at this level, Fatal, but the Ruby interpreter only uses this internally. Both ScriptError and StandardError have a number of subclasses, but we do not need to go into the details here. The important thing is that if we create our own exception classes, they need to be subclasses of either class Exception or one of its descendants. Let's look at an example:
class FileSaveError < StandardError attr_reader :reason def initialize(reason) @reason = reason end end
Now look at the following example which will use this exception:
File.open(path, "w") do |file| begin # Write out the data ... rescue # Something went wrong! raise FileSaveError.new($!) end end
The important line here is raise FileSaveError.new($!). We call raise to signal that an exception has occurred, passing it a new instance of FileSaveError, with the reason being that specific exception caused the writing of the data to fail.
*******************************************************************************

Ruby Is A Pure Object Oriented Programming Language

Uploaded by

Copyright:

Available Formats

Ruby Is A Pure Object Oriented Programming Language

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Ruby Is A Pure Object Oriented Programming Language

Uploaded by

Copyright:

Available Formats

Ruby is a pure object oriented programming language. It was created in 1993 by Yukihiro Matsumoto of Japan.

Tools You Will Need:

Popular Ruby Editors:

Interactive Ruby (IRb):

#!/usr/bin/ruby -w puts "Hello, Ruby!";

Whitespace in Ruby Program:

Line Endings in Ruby Program:

Here Document in Ruby:

Here are different examples:

# you can stack them

This will produce following result:

Ruby BEGIN Statement

This will produce following result:

Initializing Ruby Program This is main Ruby Program

Ruby END Statement

# I am a comment. Just ignore me.

name = "Madisetti" # This is again comment

Data Encapsulation: Data Abstraction: Polymorphism: Inheritance:

Defining a Class in Ruby:

class Customer end

Variables in a Ruby Class:

class Customer @@no_of_customers=0 end

Creating Objects in Ruby using new Method:

cust1 = Customer. new cust2 = Customer. new

Custom Method to create Ruby Objects :

Member Functions in Ruby Class:

class Sample def function statement 1 statement 2 end end

class Sample def hello puts "Hello Ruby!" end end

Ruby Global Variables:

Global variable in Class1 is 10 Global variable in Class2 is 10

Ruby Instance Variables:

Customer Customer Customer Customer Customer

id 1 name John address Wisdom Apartments, Ludhiya id 2 name Poul

Customer address New Empire road, Khandala

Ruby Class Variables:

Total number of customers: 1 Total number of customers: 2

Ruby Local Variables:

Value of first Constant is 100 Value of second Constant is 200

Ruby Basic Literals:

123 1_234 -500 0377 0xff 0b1011 ?a ?\n 12345678901234567890

123.4 1.0e6 4E20 4e+20

#!/usr/bin/ruby -w puts 'escape using "\\"'; puts 'That\'s right';

escape using "\" That's right

#!/usr/bin/ruby -w puts "Multiplication Value : #{24*60*60}";

Multiplication Value : 86400

For more detail on Ruby Strings, go through Ruby Strings.

fred 10 3.14 This is a string last element

green is 240 blue is 15 red is 3840

Ruby Arithmetic Operators:

a - b will give -10

a * b will give 200

a**b will give 10 to the power 20

Ruby Comparison Operators:

(a > b) is not true.

1 == 1.0 returns true, but 1.eql?(1.0) is false.

1 == 1.0 returns true, but 1.eql?(1.0) is false.

Ruby Assignment Operators:

Ruby Parallel Assignment:

Ruby Bitwise Operators:

#!/usr/bin/ruby -w puts "Multiplication Value : #{246060}";