C# - enum Array Example, Use enum as Array Index

enum Array Example, Use enum as Array Index

This page was last reviewed on Mar 26, 2022.

Enum, array indexes. An enum array has many uses. It can be accessed with enum values. This example shows how to index an array of values with enum keys.

enum

Some notes. This technique is ideal for some kinds of data such as numeric data. It provides another way to keep track of values or statistics.

Example. Enums are value types (usually Int32). Like any integer value, you can access an array with their values. Enum values are ordered starting with zero, based on their textual order.

int

Detail We see the MessageType enum, which is a series of int values you can access with strongly-typed named constants.

Detail This class contains an array. Each MessageType has an element in the array.

Array

And The enumeration values are treated as integers by using explicit casts. MessageType.Startup is 0. MessageType.Error is 5.

Finally The example shows how to loop through enumerated values. The for-loop here goes through each enum except the last one.

for

using System; /// <summary> /// Enum values used to index array. /// </summary> enum MessageType { Startup, Shutdown, Reload, Refresh, Sleep, Error, Max } /// <summary> /// Contains array of elements indexed by enums. /// </summary> static class Message { /// <summary> /// Contains one element per enum. /// </summary> public static int[] _array = new int[(int)MessageType.Max]; } class Program { static void Main() { // Assign an element using enum index. Message._array[(int)MessageType.Startup] = 3; // Assign an element. Message._array[(int)MessageType.Error] = -100; // Increment an element using enum index. Message._array[(int)MessageType.Refresh]++; // Decrement an element using enum index. Message._array[(int)MessageType.Refresh]--; // Preincrement and assign an element. int value = ++Message._array[(int)MessageType.Shutdown]; // Loop through enums. for (MessageType type = MessageType.Startup; type < MessageType.Max; type++) { Console.Write(type); Console.Write(' '); Console.WriteLine(Message._array[(int)type]); } } }

Startup 3 Shutdown 1 Reload 0 Refresh 0 Sleep 0 Error -100

Access routines. This code shows how to use a global variable array. When using global variables, consider using accessor routines, which provide a level of abstraction.

Info The example does not show any access routines, but you could implement some on Message.

public, private

Exceptions. Our code is vulnerable to exceptions during runtime. Access routines can mitigate this. But for variables that must be statics, it is still best to use separate variables.

Tip Because the array lookup must occur before getting the value, the code here is slightly slower in many cases as well.

But On the other hand, it forces the variable to stored together, which will provide better locality of reference.

A summary. Array elements can be accessed with enums. We next discussed some problems with this code and some of its benefits. Access routines can be used to make programs more reliable.

Dot Net Perls is a collection of tested code examples. Pages are continually updated to stay current, with code correctness a top priority.

Sam Allen is passionate about computer languages. In the past, his work has been recommended by Apple and Microsoft and he has studied computers at a selective university in the United States.

This page was last updated on Mar 26, 2022 (rewrite).

Home

Changes