I’ve found the Ruby Koans to be brilliant for exposing a learner to aspects of the language that are not obvious, or even weird, at first glance.

Indexing Ruby Arrays

For example, let’s look at a koan for accessing array elements:

def test_accessing_array_elements
  array = [:peanut, :butter, :and, :jelly]

  assert_equal :peanut, array[0]
  assert_equal :peanut, array.first
  assert_equal :jelly, array[3]
  assert_equal :jelly, array.last
  assert_equal :jelly, array[-1]
  assert_equal :butter, array[-3]
end

This is my first time seeing negative array references in any language. I was able to surmise (correctly) that they refer to entries counting backwards from the end of the array.

A negative index is assumed to be 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.

According to the Core API docs, indexing an array can also give us nil:

ary[index] → obj or nil

Getting a nil would seem to be the likely behavior if we try to index beyond the boundary of the array. Let’s try it:

> array [4]
=> nil

As expected, we get nil.

So far, so good. Indexing seems to work in a way mostly familiar from past experience in other languages.

Slicing Ruby Arrays

Now let’s try slicing, not indexing, arrays. The call, according to the Core API docs, is of the form:

ary[start, length] → new_ary or nil

So the array[s, n] syntax means: retrieve n elements from the array starting by the s-th position, unless there is some reason to return nil.

Let’s use the same array as before, adding it in IRB:

> array = [:peanut, :butter, :and, :jelly]
 => [:peanut, :butter, :and, :jelly]

Let’s get the first array element:

> array[0, 1]
=> [:peanut]

Which says, get me the relevant slice of the array starting at position zero, with a length of one. No difficulties so far.

If you try to access elements from the array using n=0, you will get [] as a result (within the range of the array).

Now, let’s try slicing (instead of accessing via index) beyond the end of the array:

> array [5,0]
=> nil
> array [6,10]
=> nil

No matter what starting point we try after 5, or what length we specify, we will get nil. Once again, straightforward and expected behavior.

Here’s where it got a little weird for me:

> array [4,0]
=> []
> array [4,1]
=> []
> array [4,100]
=> []

When we specify a starting point of 4, we get an empty array, regardless of how many elements we request. The semantics are subtly different at this boundary point. According to the Core API docs, it’s a special case.

The issue arises because I’m used to thinking about accessing arrays, but this is slicing. The way to think about slicing needs to be different. As a response to this question on Stack Overflow points out, treat the first number when you slice not as identifying the element, but places between elements, in order to be able to define spans (and not elements themselves):

  :peanut   :butter   :and   :jelly
0         1         2      3        4

What this means is that 4 is still within the array, from a slicing perspective; if you request 0 elements, you get the empty end of the array. But since there is no index 5, it’s outside the bounds of the array, you can’t slice from there. Indexing, of course, refers to the elements themselves.

One final example, using assignment:

t = 'hi'
t[0,0] = '('
t[3,0] = ')'
t
=> "(hi)"

In Ruby Koans these are the tests that highlight the differences:

def test_slicing_arrays
  array = [:peanut, :butter, :and, :jelly]

  assert_equal [:peanut], array[0, 1]
  assert_equal [:peanut, :butter], array[0, 2]
  assert_equal [:and, :jelly], array[2, 2]
  assert_equal [:and, :jelly], array[2, 20]
  assert_equal [], array[4,0]
  assert_equal [], array[4,100]
  assert_equal nil, array[5,0]
end

Thanks also to the My Brainstormings blog for additional help with understanding how arrays work in Ruby.

About the Author

Paul is from Perth, Australia, but chooses to live, work and play with his amazing wife and two children in Denver, Colorado. He co-founded and co-leads DDD Denver. Look for him speaking at local user groups, and at regional and international conferences.

If you are looking for an expert hands-on team coach and design mentor in Domain-Driven Design (DDD), BDD with Cucumber, or lean/agile process Paul is available for consulting and training through his company, Virtual Genius LLC.