Forbes magazine logo Ranked Best Coding Bootcamps 2023

What are Files in Ruby?

As you venture into the world of programming, you'll come across various concepts and constructs that might initially be confusing. One such concept is "Files," specifically in Ruby. In this blog post, we'll explore what Files are, how they work, and how to use them in Ruby. We'll try to keep things simple and informative, so whether you're a beginner or an experienced programmer, you'll find value in this post.

What is a File?

Before diving into the world of Ruby and its implementation of Files, let's first understand what a File is from a general perspective. A File can be thought of as a container that stores information or data. This data can be anything – text, images, videos, or any other type of content. Files are stored on your computer's hard drive or other storage devices and are usually organized into folders to make it easier to find and manage them.

In the context of programming, Files are crucial because they allow us to store, read, and modify data. When you're working on a software project, you'll often need to read data from a File, process it, and then write the results back to another File. This is where Ruby's File handling capabilities come in handy.

A Glimpse of Ruby's File Class

Ruby offers a built-in class called File that provides a wide array of methods to work with Files. The File class is derived from another class called IO (Input/Output), which provides fundamental methods for reading and writing data. In other words, the File class inherits the capabilities of the IO class and builds upon them to offer more specialized methods for File handling.

Don't worry if the terms "class," "methods," or "inheritance" seem confusing. For now, just think of them as tools Ruby provides to help us work with Files more efficiently. We'll discuss these concepts in more detail later on.

Opening and Closing Files

Before we can work with a File in Ruby, we need to open it. Opening a File establishes a connection between our program and the File, allowing us to read or write data. Once we're done working with the File, we need to close the connection to prevent any potential issues or resource leaks.

Ruby provides a method called open to open a File. The basic syntax for opening a File is:

file ="file_name.txt", "mode")

Here, "file_name.txt" is the name of the File you want to open, and "mode" represents the mode in which you want to open the File. The mode determines what you can do with the File – read, write, or both. Some common modes are:

  • "r": Read-only mode. You can only read the File's content. This is the default mode if you don't specify one.
  • "w": Write-only mode. You can only write to the File. If the File doesn't exist, it will be created. If it exists, its content will be truncated (i.e., removed) before writing.
  • "a": Append mode. You can write to the File, but the existing content will not be removed. New data will be added at the end of the File.
  • "r+": Read and write mode. You can both read and write to the File.

Once you've finished working with a File, you can close it using the close method:


Here's a simple example that demonstrates opening and closing a File:

# Opening a File in read-only mode
file ="sample.txt", "r")

# Do something with the File...

# Closing the File

Reading Files

Now that we know how to open and close Files, let's discuss how to read their contents. Ruby provides several methods to read data from a File.

The read Method

The read method reads the entire content of the File and returns it as a string. Here's an example:

file ="sample.txt", "r")

content =

puts content


The readlines Method

The readlines method reads the entire content of the File and returns it as an array of lines. Each element in the array represents a line in the File. Here's an example:

file ="sample.txt", "r")

lines = file.readlines

puts lines


The each_line Method

The each_line method is used to iterate over the lines of a File. It reads one line at a time and executes the code block for each line. Here's an example:

file ="sample.txt", "r")

file.each_line do |line|
  puts line


Writing Files

Writing data to a File is just as easy as reading it. Ruby provides several methods to write data to a File.

The write Method

The write method writes a string to the File. Here's an example:

file ="output.txt", "w")

file.write("This is a sample text.")


The puts Method

The puts method writes a string to the File, followed by a newline character. This is useful when you want to write multiple lines to a File. Here's an example:

file ="output.txt", "w")

file.puts("This is the first line.")
file.puts("This is the second line.")


File Modes and Permissions

As we've mentioned earlier, File modes determine what you can do with a File – read, write, or both. However, you also need to consider the File's permissions before you can perform these operations. Permissions are set at the operating system level and dictate who can perform which operations on a File.

In Ruby, you can check a File's permissions using the stat method, which returns an object containing various information about the File, such as its permissions, size, and the time it was last modified. You can then use the mode method on the stat object to get the permissions.

Here's an example that prints the permissions of a File:

file_stat = File.stat("sample.txt")

puts "File permissions: #{file_stat.mode}"

Keep in mind that if a File's permissions don't allow you to perform a specific operation, Ruby will raise an error.

The File Class and Ruby's Elegant Syntax

Ruby's File class is powerful, but it can be made even more elegant with some of Ruby's syntax features. For example, you can use the File class in conjunction with a block to automatically close the File after the block's execution. This is a more idiomatic and resource-efficient way of handling Files in Ruby.

Here's an example:"sample.txt", "r") do |file|
  content =
  puts content

In this example, the File is automatically closed once the block is executed, so you don't need to call the close method explicitly.


In this blog post, we've explored the concept of Files and how to work with them in Ruby. We've covered various methods provided by the File class to open, read, write, and close Files, as well as checking their permissions. We've also discussed Ruby's elegant syntax that makes working with Files even more efficient.

By understanding the basics of File handling in Ruby, you're now equipped to tackle more complex tasks that involve reading and writing data to Files. As you continue learning programming, remember to explore different ways to accomplish a task and always strive to write clean, efficient, and readable code. Happy coding!