4,127 reads

C# 8.0 Indices and Ranges

by Miguel BernardMarch 22nd, 2020

Too Long; Didn't Read

Microsoft just improved the C# syntax, making it easier for developers to manage data in arrays. Two new operators have been introduced in C# 8.0 to give you all the power you need. The 'Index from the end' operator specifies that an index is relative to the end of the sequence; and 'range' operator:. The index is the same as a number n, the index n is equal to words[9], which is out of range. For ranges, the start of the range is inclusive, but the end is exclusive.

Companies Mentioned

featured image - C# 8.0 Indices and Ranges

Compared to other languages, C# was way behind in capabilities to handle data efficiently. Well, those days are over now. Microsoft just improved the C# syntax, making it easier for developers to manage data in arrays.

Manipulating Arrays

Have you ever had to manipulate a large set of data in multiple arrays? Of course you have! And I guess your experience wasn't that good. Compared to other languages, C# was way behind in capabilities to handle data efficiently. Well, those days are over now. Microsoft just improved the C# syntax, making it easier for developers to manage data in arrays.

The new guys

Two new operators have been introduced in C# 8.0 to give you all the power you need:

The 'index from the end' operator:
```
^
```
, which specifies that an index is relative to the end of the sequence; and
The 'range' operator:
```
..
```
, which specifies the start and end of a range.

Important notes

The
```
^0
```
index is the same as
```
sequence[sequence.Length]
```
.

Be careful,

sequence[^0]

does throw an

IndexOutOfRangeException

, just as

sequence[sequence.Length]

does.

For any number n, the index
```
^n
```
is the same as
```
sequence.Length - n
```
.
For ranges, the start of the range is inclusive, but the end of the range is exclusive.
The range
```
[0..0^]
```
represents the entire sequence, just as
```
[0..sequence.Length]
```
or
```
[..]
```
.
A range doesn't need to be completely defined,
e.g.
```
[..3]
```
-> give me everything from the start of the array to index 3.
```
[2..]
```
-> give me everything from index 2 until the end of the array.
```
[..]
```
-> give me everything

Examples

Confused? I promise it will all make sense after this. Let's look at a few examples.

private string[] words = new string[]
{
                // index from start    index from end
    "The",      // 0                   ^9
    "quick",    // 1                   ^8
    "brown",    // 2                   ^7
    "fox",      // 3                   ^6
    "jumped",   // 4                   ^5
    "over",     // 5                   ^4
    "the",      // 6                   ^3
    "lazy",     // 7                   ^2
    "dog"       // 8                   ^1
};

As you can see here
words[^0]
is equal to
words[9]
, which is out of range

Give me some more

Alright, alright. Here are some more ways to use it.

var allWords = words[..]; // contains "The" through "dog".
var firstPhrase = words[..4]; // contains "The" through "fox".
var lastPhrase = words[6..]; // contains "the, "lazy" and "dog".
var lazyDog = words[^2..^0]; // contains "lazy" and "dog".

Index

and

Range

are also .NET types, which means you can create variables of those types, name them for code clarity, and reuse them over and over.

Index the = ^3;
words[the];

Range phrase = 1..4;
words[phrase];

Conclusion

This is super powerful, I can't wait to use it in my projects. This will help so much with reducing noise when using index calculations as well as making the code more maintainable. Thank you Microsoft for this great addition to the language ❤️.

References

https://docs.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-8

Previously published at https://blog.miguelbernard.com/c-8-0-indices-and-ranges/