C# coding standards” Use the const directive only on natural constants

Question

I've seen these 2 guidelines in coding c# standard and I’m not sure the what the 2nd one means.

1. With the exception of zero and one, never hard-code a numeric value; always declare a constant instead.
2. Use the const directive only on natural constants such as the number of days of the week.

What is the definition of a natural constants and if the number is not a natural constants given the 1st rule how does one declare a constant in c# without the const directive?

So how is the 2nd rule not contradicting the 1st rule for non natural constants?

See http://www.scribd.com/doc/10731655/IDesign-C-Coding-Standard-232 for reference.

Answer 1

You cannot declare a "constant" without the const directive. When it refers to "natural constants" it's simply referring to values which are defined by an immovably obvious guarantee, something that is axiomatic, for example:

There are 7 days in a week. This will never change.

There are 12 inches in a foot. This will never change.

These seem pretty fixed and hard to identify relatably to a real situation though, there are however fixed guarantees similar to this which you can find in your own systems surely.

For example, say you're writing a web service, and you are versioning the contracts as you should, so you have an OblogonRepository service, it would be reasonable to claim inside that service:

This is version 1 of the OblogonRepository. This will never change.

---

Now that all of that has been said, let me go on to say, this rule sounds very restrictive and I don't particularly agree with it.

It is however very important to understand the behaviour of a const in C#, in relation to this: Everywhere a const is referenced, it will at compile time be replaced by a fixed reference to the literals in the assemblies table. This means if you have other assemblies referencing this const, and you compile them then recompile the assembly with the const with changed values, the referencing assemblies will not have the const value updated until you recompile them.

Do be cautious with consts, but in my personal subjective opinion, this rule is far more restrictive than is useful. Using consts for things like max allowed users or column numbers is completely common idiomatic C#, even though they may change unlike "natural numbers".

Here's a little further reading on consts which details their compile time behaviour: Link

This article claims a rule which sounds pretty spot on to me (emphasis mine):

Thus, const should be used mainly for values that are not subject to change, or [can be used] freely if the scope of the const is limited to the same assembly or smaller.

Answer 2

I think you can read "Natural Constant" as "This is a well-known and well-understood number, and is unlikely to ever change." Constants like e and pi meet this definition.

Magic numbers like seeds for pseudo-random number generators are not natural constants and, according to this coding standard, are better served by using the readonly keyword.

Answer 3

Let's pretend that you have been tasked with writing an program that manages a satellite's trajectory in orbit. You wrote this program expecting the satellite to orbit earth, so all your calculation is done with a gravity constant of 9.81. Well, NASA decides to send this satellite to the Moon, where the gravity is 1/6 of the earth. You hard coded the gravity constant in your app, so Joe Schmo goes through your source code, changing all instances of 9.81 to 1.66. Except Joe Schmo forgot to change 1 formula, and the multi-billion dollar satellite crashes and burns on the moon's surface because 1 formula was using Earth's gravitational constant. By declaring a constant for gravity and using that constant every place you need gravity, any change to that constant can be implemented by changing 1 line of code, instead of five thousand lines.

So that's the WHY one should use constants instead of hard coding them in.

You cannot declare a constant without using the const directive. And if you are declaring a constant, use the const directive. You can only assign a constant a value when you declare it. For example:

   public const float Gravity = 9.81;
   Gravity = 1.6;

will not compile because you are attempting to change the value of a constant.

A natural constant is something that will never change: The length of an inch. The acceleration due to gravity on earth. The number of days in a week. The number of days in January. The ratio of cms to inches. These are all natural constants.

Answer 4

What you get when you use a constant is a description of the value and a single point of change. A constant is a hard-coded value. All the uses of the constant variable are replaced with the actual value at compile time.

As for when to use const... you can use a const or you can't. I use const whenever I can, my program will have to track one less variable and will be that much more efficient.

Answer 5

Let’s say I use the constant 24 for number of hours in a day. That number is never going to change. I also use a constant 24 for number of items printed per page. That number could change, so I should give it a name.

But hours per day should also be named, because otherwise every time I see that constant 24 I don’t know what constant it is - hours per day, lines per page etc.

So any small numbers should be named. If I see 3.141592653589 I actually now it is pi, you don’t need to name it. And 0, 1, possibly 2, mean exactly that. They shouldn’t be named.