What is an “index out of range” exception, and how do I fix it? [duplicate]

by

Why does this error occur?

Because you tried to access an element in a collection, using a numeric index that exceeds the collection’s boundaries.

The first element in a collection is generally located at index 0. The last element is at index n-1, where n is the Size of the collection (the number of elements it contains). If you attempt to use a negative number as an index, or a number that is larger than Size-1, you’re going to get an error.

How indexing arrays works

When you declare an array like this:

var array = new int[6]

The first and last elements in the array are

var firstElement = array[0];
var lastElement = array[5];

So when you write:

var element = array[5];

you are retrieving the sixth element in the array, not the fifth one.

Typically, you would loop over an array like this:

for (int index = 0; index < array.Length; index++)
{
    Console.WriteLine(array[index]);
}

This works, because the loop starts at zero, and ends at Length-1 because index is no longer less than Length.

This, however, will throw an exception:

for (int index = 0; index <= array.Length; index++)
{
    Console.WriteLine(array[index]);
}

Notice the <= there? index will now be out of range in the last loop iteration, because the loop thinks that Length is a valid index, but it is not.

How other collections work

Lists work the same way, except that you generally use Count instead of Length. They still start at zero, and end at Count - 1.

for (int index = 0; i < list.Count; index++)
{
    Console.WriteLine(list[index]);
}

However, you can also iterate through a list using foreach, avoiding the whole problem of indexing entirely:

foreach (var element in list)
{
    Console.WriteLine(element.ToString());
}

You cannot index an element that hasn’t been added to a collection yet.

var list = new List<string>();
list.Add("Zero");
list.Add("One");
list.Add("Two");
Console.WriteLine(list[3]);  // Throws exception.

More Related Contents:

  1. What is an IndexOutOfRangeException / ArgumentOutOfRangeException and how do I fix it?
  2. What’s the fastest way to read a text file line-by-line?
  3. Maximum number of threads in a .NET app?
  4. Is floating-point math consistent in C#? Can it be?
  5. How to create a simple proxy in C#?
  6. What’s the difference between SortedList and SortedDictionary?
  7. Headless browser for C# (.NET)? [closed]
  8. What is the difference between “x is null” and “x == null”?
  9. Multiple actions were found that match the request in Web Api
  10. .NET – What’s the best way to implement a “catch all exceptions handler”
  11. Multiple Parallel.ForEach loops in .Net
  12. How to put a task to sleep (or delay) in C# 4.0?
  13. How do I get information about recently connected USB device?
  14. How to check if another instance of the application is running [duplicate]
  15. Why is AddRange faster than using a foreach loop?
  16. Using WebClient in C# is there a way to get the URL of a site after being redirected?
  17. Received an invalid column length from the bcp client for colid 6
  18. Looking for an example of a custom SynchronizationContext (Required for unit testing)
  19. How do I get common file type icons in C#?
  20. How to capture the screen and mouse pointer using Windows APIs?
  21. Setting the initial directory of an SaveFileDialog?
  22. How to convert object to Dictionary in C#?
  23. Remove readonly attribute from directory
  24. Is my process waiting for input?
  25. Developing C# on Linux [closed]
  26. Access to disposed closure in C#?
  27. How to install a Font programmatically (C#)
  28. Timeout pattern on task-based asynchronous method in C#
  29. How to find index of sublist in list?
  30. System.Net.Mail creating invalid emails and eml files? Inserting extra dots in host names

Leave a Comment