Also in this series
- C# 8.0 Nullable Reference types are here!
- Pattern matching in C#
- Asynchronous streams
- Indices and ranges
- Default interface methods
- 5 tips to improve your productivity in C# 8.0
All code samples are available on github
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 assequence[sequence.Length]
.- Be careful,
sequence[^0]
does throw anIndexOutOfRangeException
, just assequence[sequence.Length]
does.
- Be careful,
- For any number n, the index
^n
is the same assequence.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 index3
. -
[2..]
-> give me everything from index2
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 towords[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
Also in this series
- C# 8.0 Nullable Reference types are here!
- Pattern matching in C#
- Asynchronous streams
- Indices and ranges
- Default interface methods
- 5 tips to improve your productivity in C# 8.0
All code samples are available on github
Top comments (1)
I'm expecting a multitude of
IndexOutOfRangeException
. with this new backwards index operator.I wonder what where they thinking when having the backwards index start with one instead of zero...