View source for Ruby String Replacement, Substitution and Insertion

<table border="0" cellspacing="0" width="100%">
<tr>
<td width="20%">[[Ruby String Concatenation and Comparison|Previous]]<td align="center">[[Ruby Essentials|Table of Contents]]<td width="20%" align="right">[[Ruby String Conversions|Next]]</td>
<tr>
<td width="20%">Ruby String Concatenation and Comparison<td align="center"><td width="20%" align="right">Ruby String Conversions</td>
</table>
<hr>


<<htmlet>ruby</htmlet>


In this chapter we will look at some string manipulation techniques available in Ruby. Such techniques include string substitution, multiplication and insertion. We will also take a look at the Ruby ''chomp'' and ''chop'' methods.

== Changing a Section of a String ==

Ruby allows part of a string to be modified through the use of the []= method. To use this method, simply pass through the string of characters to be replaced to the method and assign the new string. As is often the case, this is best explained through the use of an example:

<pre>
myString = "Welcome to JavaScript!"

myString["JavaScript"]= "Ruby"

puts myString
=> "Welcome to Ruby!"
</pre>

As you can see, we replaced the word "JavaScript" with "Ruby".

The []= method can also be passed an index representing the index at with the replacement is to take place. In this instance the single character at the specified location is replaced by the designated string:

<pre>
myString = "Welcome to JavaScript!"
myString[10]= "Ruby"

puts myString
=> "Welcome toRubyJavaScript!"
</pre>

Perhaps a more useful trick is to specify an index range to be replaced. For example we can replace the characters from index 8 through to index 20 inclusive:

<pre>
myString = "Welcome to JavaScript!"
=> "Welcome to JavaScript!"

myString[8..20]= "Ruby"
=> "Ruby"

puts myString
=> "Welcome Ruby!"
</pre>

== Ruby String Substitution ==

The ''gsub'' and ''gsub!'' methods provide another quick and easy way of replacing a substring with another string. These methods take two arguments, the search string and the replacement string. The ''gsub'' method returns a modified string, leaving the original string unchanged, whereas the ''gsub!'' method directly modify the string object on which the method was called:

<pre>
myString = "Welcome to PHP Essentials!"
=> "Welcome to PHP Essentials!"

myString.gsub("PHP", "Ruby")
=> "Welcome to Ruby Essentials!"
</pre>

An entire string, as opposed to a substring, may be replaced using the ''replace'' method:

<pre>
myString = "Welcome to PHP!"
=> "Welcome to PHP!"

myString.replace "Goodbye to PHP!"
=> "Goodbye to PHP!"
</pre>

== Repeating Ruby Strings ==

A string may be multiplied using the * method (not something I have ever needed to do myself, but the capability is there if you need it):

<pre>
myString = "Is that an echo? "
=> "Is that an echo? "

myString * 3
=> "Is that an echo? Is that an echo? Is that an echo? "
</pre>

== Inserting Text into a Ruby String ==
<htmlet>adsdaqbox_flow</htmlet>
So far in this chapter we have looked exclusively at changing the existing text contained in a Ruby string object. Another common requirement is to insert new text at a certain location in a string. This is achieved in Ruby using the ''insert'' method. The insert method takes as arguments index position into the string where the insertion is take place, followed by the string to be inserted


<pre>
myString = "Paris in Spring"

myString.insert 8, " the"
=> "Paris in the Spring"
</pre>

== Ruby chomp and chop Methods ==

The purpose of the ''chop'' method is to remove the trailing character from a string:

<pre>
myString = "Paris in the Spring!"
=> "Paris in the Spring!"

myString.chop
=> "Paris in the Spring"
</pre>

Note that ''chop'' returns a modified string, leaving the original string object unchanged. Use ''chop!'' to have the change applied to the string object on which the method was called.

The ''chomp'' method removes ''record separators'' from a string. The record separator is defined by the $/ variable and is, by default, the new line character (\n). As with the ''chop'' method the ''chomp!'' variant of the method applies the change to string object on which the method is called:

<pre>
myString = "Please keep\n off the\n grass"
=> "Please keep\n off the\n grass\n"

myString.chomp!
=> "Please keep\n off the\n grass"
</pre>

== Reversing the Characters in a String == 

The ''reverse'' method is used to reverse the contents of a string:

<pre>
myString = "Paris in the Spring"
=> "Paris in the Spring"

myString.reverse
=> "gnirpS eht ni siraP"
</pre>

Once again, not something I've ever needed to do in all my years as a developer, but you never know when you might need to do it.


<htmlet>ruby</htmlet>


<hr>
<table border="0" cellspacing="0" width="100%">
<tr>
<td width="20%">[[Ruby String Concatenation and Comparison|Previous]]<td align="center">[[Ruby Essentials|Table of Contents]]<td width="20%" align="right">[[Ruby String Conversions|Next]]</td>
<tr>
<td width="20%">Ruby String Concatenation and Comparison<td align="center"><td width="20%" align="right">Ruby String Conversions</td>
</table>