Abbey Workshop | ||||||||||
This howto covers the basics of reading a text file in Ruby. As with most scripting languages there is more than one way to do this, but hopefully the most straight forward methods are covered here. Below are three different examples of reading a text file. Each example reads a file and prints the file along with the line numbers for that file.
Download source for: readfile.rb
The first example on lines 4-11 shows a method for reading the file that would seem pretty typical. On line 6, a file object is created with the new method and the file is open for reading. The file name and read/write mode is specified. Your file mode options are as follows:
| Mode | Description |
|---|---|
| r | Read-only, starts at beginning of file (default mode). |
| r+ | Read-write, starts at beginning of file. |
| w | Write-only, truncates existing file to zero length or creates a new file for writing. |
| w+ | Read-write, truncates existing file to zero length or creates a new file for reading and writing. |
| a | Write-only, starts at end of file if file exists, otherwise creates a new file for writing. |
| a+ | Read-write, starts at end of file if file exists, otherwise creates a new file for reading and writing. |
The while loop is defined on line 7. Notice that the gets method is used to read each line. Ruby has a readline method as well, but it raises an exception when the end of the file is reached. The gets method returns nil when the end of the file is reached. Thus it is preferable as no error is generated.
The second example reads the file by passing it to a block. Notice that on line 14 the open method is used instead of new. This passes the file right to the block without having to create an object. The advantage of this approach is that you don't have to close the file with the close method.
The third example shows you how to gracefully catch an exception and exit the application if something goes wrong. This is similar to a die statement in Perl for a try/catch block in Java. The code is surrounded by a begin and end block. A rescue statement follows the code and will catch any exception thrown and print the error message. Of course there is more to Ruby exceptions, but that is not covered in this how to.
Copyright © Abbey Workshop 2006