665

Which one is better to use among the below statements in C?

static const int var = 5;

or

#define var 5

or

enum { var = 5 };
4
  • 51
    Interestingly, this is almost exactly the same question as stackoverflow.com/questions/1637332/static-const-vs-define. The only difference is that that question is about C++, and this one is about C. Since my answer was C++ specific, I say that makes them not identical, but others may disagree.
    – T.E.D.
    Nov 4, 2009 at 15:09
  • 69
    Not identical, definitely. There is a whole lot of areas where C++ allows C syntax for compatibility reasons. In those cases, questions like "what is the best way to do X" will have different answers in C++. E.g. object initialization.
    – MSalters
    Nov 4, 2009 at 15:33
  • 1
    Also: stackoverflow.com/questions/1944041/…
    – jamesdlin
    Aug 10, 2017 at 2:07
  • 1
    How is this not opinion based? They each have a different purpose Dec 28, 2017 at 13:28

17 Answers 17

796

It depends on what you need the value for. You (and everyone else so far) omitted the third alternative:

  1. static const int var = 5;
  2. #define var 5
  3. enum { var = 5 };

Ignoring issues about the choice of name, then:

  • If you need to pass a pointer around, you must use (1).
  • Since (2) is apparently an option, you don't need to pass pointers around.
  • Both (1) and (3) have a symbol in the debugger's symbol table - that makes debugging easier. It is more likely that (2) will not have a symbol, leaving you wondering what it is.
  • (1) cannot be used as a dimension for arrays at global scope; both (2) and (3) can.
  • (1) cannot be used as a dimension for static arrays at function scope; both (2) and (3) can.
  • Under C99, all of these can be used for local arrays. Technically, using (1) would imply the use of a VLA (variable-length array), though the dimension referenced by 'var' would of course be fixed at size 5.
  • (1) cannot be used in places like switch statements; both (2) and (3) can.
  • (1) cannot be used to initialize static variables; both (2) and (3) can.
  • (2) can change code that you didn't want changed because it is used by the preprocessor; both (1) and (3) will not have unexpected side-effects like that.
  • You can detect whether (2) has been set in the preprocessor; neither (1) nor (3) allows that.

So, in most contexts, prefer the 'enum' over the alternatives. Otherwise, the first and last bullet points are likely to be the controlling factors — and you have to think harder if you need to satisfy both at once.

If you were asking about C++, then you'd use option (1) — the static const — every time.

24
  • 132
    fantastic list! One drawback with enum is that they're implemented as int ([C99] 6.7.2.2/3). A #define lets you specify unsigned and long with U and L suffixes, and const lets you give a type. enum can cause problems with usual type conversions.
    – Gauthier
    Mar 1, 2011 at 9:33
  • 52
    (2) people ALWAYS complain about type safety. I never understand why not just use "#define var ((int)5)" and hurray you got type safety with a define. Nov 26, 2013 at 23:23
  • 12
    @RedX: you would have to be in a very peculiar environment for space to a concern. That said, neither enum nor #define uses extra space, per se. The value will appear in the object code as part of the instructions rather than being allocated storage in the data segment or in heap or on the stack. You'll have some space allocated for the static const int, but the compiler might optimize it away if you don't take an address. Feb 7, 2014 at 15:04
  • 20
    Another 'vote' for enums (and static const): they can't be changed. a define can be #undefine'd where an enum and static const are fixed to the value given. Jul 8, 2014 at 9:46
  • 22
    @QED: No, thank you. A simple constant is safe outside parentheses. Or, show me how a program that could legitimately be expected to compile would be altered by not having the 5 in parentheses. If it was the argument to a function-style macro, or if there were any operators in the expression, then you'd be correct to blame me had I not included the parentheses. But that isn't the case here. Mar 27, 2015 at 3:59
285

Generally speaking:

static const

Because it respects scope and is type-safe.

The only caveat I could see: if you want the variable to be possibly defined on the command line. There is still an alternative:

#ifdef VAR // Very bad name, not long enough, too general, etc..
  static int const var = VAR;
#else
  static int const var = 5; // default value
#endif

Whenever possible, instead of macros / ellipsis, use a type-safe alternative.

If you really NEED to go with a macro (for example, you want __FILE__ or __LINE__), then you'd better name your macro VERY carefully: in its naming convention Boost recommends all upper-case, beginning by the name of the project (here BOOST_), while perusing the library you will notice this is (generally) followed by the name of the particular area (library) then with a meaningful name.

It generally makes for lengthy names :)

18
  • 2
    Agreed - also with #define there's a general danger of mangling code as the preprocessor is not aware of syntax.
    – NeilDurant
    Nov 4, 2009 at 14:27
  • 10
    Its better to use #if than #ifdef , but otherwise I agree. +1.
    – Tim Post
    Nov 4, 2009 at 15:32
  • 65
    This is standard C++ evangelism. The answer below is MUCH clearer in explaining what the options really are and mean. In particular: I just had a problem with "static const". Someone used it to define around 2000 "constants" in a header file. Then this header file was included in around 100 ".c" and ".cpp" files. => 8Mbytes for "consts". Great. Yes I know that you might use a linker to remove unreferenced consts, but then this still leaves you which the "consts" which ARE referenced. Running out of space what's all wrong with this answer. Nov 26, 2013 at 23:19
  • 2
    @IngoBlackman: With a good compiler, only those static whose address is taken should remain; and if the address is taken one could not have used a #define or enum (no address)... so I really fail to see what alternative could have been used. If you can do away with "compile time evaluation", you might be looking for extern const instead. Nov 27, 2013 at 7:41
  • 15
    @Tim Post: #if might be preferable over #ifdef for boolean flags, but in this case it would make it impossible to define var as 0 from the command line. So in this case, #ifdef makes more sense, as long as 0 is a legal value for var.
    – Maarten
    Jan 5, 2014 at 16:44
113

In C, specifically? In C the correct answer is: use #define (or, if appropriate, enum)

While it is beneficial to have the scoping and typing properties of a const object, in reality const objects in C (as opposed to C++) are not true constants and therefore are usually useless in most practical cases.

So, in C the choice should be determined by how you plan to use your constant. For example, you can't use a const int object as a case label (while a macro will work). You can't use a const int object as a bit-field width (while a macro will work). In C89/90 you can't use a const object to specify an array size (while a macro will work). Even in C99 you can't use a const object to specify an array size when you need a non-VLA array.

If this is important for you then it will determine your choice. Most of the time, you'll have no choice but to use #define in C. And don't forget another alternative, that produces true constants in C - enum.

In C++ const objects are true constants, so in C++ it is almost always better to prefer the const variant (no need for explicit static in C++ though).

5
  • 7
    "you can't use a const int object as a case label (while a macro will work) " ---> Regarding this statement i tested a const int variable in C in switch- case it is working ....
    – john
    Feb 10, 2012 at 6:24
  • 9
    @john: Well, you need to provide the code that you tested and name the specific compiler. Using const int objects in case-labels is illegal in all versions of C language. (Of course, your compiler is free to support it as a non-standard C++-like language extension.) Feb 10, 2012 at 23:46
  • 12
    "... and therefore are usually useless in most practical cases." I disagree. They're perfectly useful as long as you don't need to use the name as a constant expression. The word "constant" in C means something that can be evaluated at compile time; const means read-only. const int r = rand(); is perfectly legal. Feb 26, 2014 at 16:51
  • In c++, it is better to use constexpr as compared to const specially with the stl containers like array or bitset. Aug 2, 2016 at 10:28
  • 1
    @john you must've tested in switch() statement, not in case one. I've just got caught on this one too ☺
    – Hi-Angel
    May 17, 2017 at 15:00
37

The difference between static const and #define is that the former uses the memory and the later does not use the memory for storage. Secondly, you cannot pass the address of an #define whereas you can pass the address of a static const. Actually it is depending on what circumstance we are under, we need to select one among these two. Both are at their best under different circumstances. Please don't assume that one is better than the other... :-)

If that would have been the case, Dennis Ritchie would have kept the best one alone... hahaha... :-)

3
  • 6
    +1 for mentioning memory, some embedded systems still don't have that much, though I would probably start off using static consts and only change to #defines if needed.
    – fluffyben
    Mar 7, 2012 at 11:36
  • 3
    I just tested it. Indeed, const int uses additional memory compared to #define or enum. Since we program embedded systems, we can't afford the additional memory usage. So, we'll go back to using #define or enum. Mar 2, 2015 at 17:51
  • 5
    Practically speaking it is not true (anymore) that a const does use memory. GCC (tested with 4.5.3 and a few newer versions) easily optimizes the const int into a direct literal in your code when using -O3. So if you do low RAM embedded development (e.g. AVR) you can safely use C consts if you use GCC or another compatible compiler. I have not tested it but expect Clang to do the same thing btw.
    – Raphael
    Dec 10, 2015 at 18:43
19

In C #define is much more popular. You can use those values for declaring array sizes for example:

#define MAXLEN 5

void foo(void) {
   int bar[MAXLEN];
}

ANSI C doesn't allow you to use static consts in this context as far as I know. In C++ you should avoid macros in these cases. You can write

const int maxlen = 5;

void foo() {
   int bar[maxlen];
}

and even leave out static because internal linkage is implied by const already [in C++ only].

4
  • 1
    What do you mean with "internal linkage"? I can have const int MY_CONSTANT = 5; in one file and access it with extern const int MY_CONSTANT; in another. I could not find any info in the standard (C99 at least) about const changing the default behaviour "6.2.2:5 If the declaration of an identifier for an object has file scope and no storage-class specifier, its linkage is external".
    – Gauthier
    Jan 19, 2011 at 12:10
  • @Gauthier: Sorry, about that. I should have said "is implied by const already in the C++ language". This is specific to C++.
    – sellibitze
    Jan 21, 2011 at 21:05
  • @sellibitze it's nice to see some arguments along the way instead of tons of OPINION If there would be bonus for true arguments, you got it!
    – Paul
    Feb 16, 2014 at 13:07
  • 4
    As of C99, your second snippet is legal. bar is a VLA (variable length array); the compiler is likely to generate code as if its length were constant. Feb 26, 2014 at 16:53
15

Another drawback of const in C is that you can't use the value in initializing another const.

static int const NUMBER_OF_FINGERS_PER_HAND = 5;
static int const NUMBER_OF_HANDS = 2;

// initializer element is not constant, this does not work.
static int const NUMBER_OF_FINGERS = NUMBER_OF_FINGERS_PER_HAND 
                                     * NUMBER_OF_HANDS;

Even this does not work with a const since the compiler does not see it as a constant:

static uint8_t const ARRAY_SIZE = 16;
static int8_t const lookup_table[ARRAY_SIZE] = {
    1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16}; // ARRAY_SIZE not a constant!

I'd be happy to use typed const in these cases, otherwise...

6
  • 5
    A little late to the game, but this question came up in another question. Chasing down why your static uint8_t const ARRAY_SIZE = 16; all of a sudden no longer compiles can be a bit challenging, particularly when the #define ARRAY_SIZE 256 is buried ten layers deep in a tangled web of headers. That all caps name ARRAY_SIZE is asking for trouble. Reserve ALL_CAPS for macros, and never define a macro that is not in ALL_CAPS form. Sep 3, 2011 at 2:35
  • @David: sound advice, which I will follow.
    – Gauthier
    Sep 5, 2011 at 7:02
  • It's due to 'static' storage, not 'const' qualifier
    – tstanisl
    Sep 3, 2021 at 19:36
  • @tstanisl well yes, since these statics need initialization, which I think happens at compile time. I was just referring to this way to define "constants". Strangely enough, my first code example now works, with gcc 9.3.0, even with --stc=c89. The second one doesn't, the compiler complains about "variably modified array"... since ARRAY_SIZE is a (read-only) variable, not a constant.
    – Gauthier
    Sep 5, 2021 at 8:44
  • @Gauthier, the first example works with all C standard (c89,c99,c11,c18) with GCC and CLANG in pedantic mode. Interesting. It looks that static variables can be used to initialize other static variables.
    – tstanisl
    Sep 5, 2021 at 19:51
11

If you can get away with it, static const has a lot of advantages. It obeys the normal scope principles, is visible in a debugger, and generally obeys the rules that variables obey.

However, at least in the original C standard, it isn't actually a constant. If you use #define var 5, you can write int foo[var]; as a declaration, but you can't do that (except as a compiler extension" with static const int var = 5;. This is not the case in C++, where the static const version can be used anywhere the #define version can, and I believe this is also the case with C99.

However, never name a #define constant with a lowercase name. It will override any possible use of that name until the end of the translation unit. Macro constants should be in what is effectively their own namespace, which is traditionally all capital letters, perhaps with a prefix.

2
  • 6
    Unfortunately, this is not the case with C99. const in C99 is still not a real constant. You can declare array size with a const in C99, but only because C99 supports Variable Length Arrays. For this reason, it will only work where VLAs are allowed. For example, even in C99, you still can't use a const to declare size of a member array in a struct. Nov 6, 2009 at 0:25
  • 1
    While it is correct that C99 won't let you do that, GCC (tested with 4.5.3) will perfectly let you initialize arrays with a const int size as if it were a C++ const or a macro. Whether you want to depend on this deviation of GCC from the standard is of course your choice, I'd personally go with it unless you can really forsee using another compiler than GCC or Clang, the latter has the same feature here (tested with Clang 3.7).
    – Raphael
    Dec 10, 2015 at 18:46
9

It is ALWAYS preferable to use const, instead of #define. That's because const is treated by the compiler and #define by the preprocessor. It is like #define itself is not part of the code (roughly speaking).

Example:

#define PI 3.1416

The symbolic name PI may never be seen by compilers; it may be removed by the preprocessor before the source code even gets to a compiler. As a result, the name PI may not get entered into the symbol table. This can be confusing if you get an error during compilation involving the use of the constant, because the error message may refer to 3.1416, not PI. If PI were defined in a header file you didn’t write, you’d have no idea where that 3.1416 came from.

This problem can also crop up in a symbolic debugger, because, again, the name you’re programming with may not be in the symbol table.

Solution:

const double PI = 3.1416; //or static const...
8

#define var 5 will cause you trouble if you have things like mystruct.var.

For example,

struct mystruct {
    int var;
};

#define var 5

int main() {
    struct mystruct foo;
    foo.var = 1;
    return 0;
}

The preprocessor will replace it and the code won't compile. For this reason, traditional coding style suggest all constant #defines uses capital letters to avoid conflict.

6

I wrote quick test program to demonstrate one difference:

#include <stdio.h>

enum {ENUM_DEFINED=16};
enum {ENUM_DEFINED=32};

#define DEFINED_DEFINED 16
#define DEFINED_DEFINED 32

int main(int argc, char *argv[]) {

   printf("%d, %d\n", DEFINED_DEFINED, ENUM_DEFINED);

   return(0);
}

This compiles with these errors and warnings:

main.c:6:7: error: redefinition of enumerator 'ENUM_DEFINED'
enum {ENUM_DEFINED=32};
      ^
main.c:5:7: note: previous definition is here
enum {ENUM_DEFINED=16};
      ^
main.c:9:9: warning: 'DEFINED_DEFINED' macro redefined [-Wmacro-redefined]
#define DEFINED_DEFINED 32
        ^
main.c:8:9: note: previous definition is here
#define DEFINED_DEFINED 16
        ^

Note that enum gives an error when define gives a warning.

5

The definition

const int const_value = 5;

does not always define a constant value. Some compilers (for example tcc 0.9.26) just allocate memory identified with the name "const_value". Using the identifier "const_value" you can not modify this memory. But you still could modify the memory using another identifier:

const int const_value = 5;
int *mutable_value = (int*) &const_value;
*mutable_value = 3;
printf("%i", const_value); // The output may be 5 or 3, depending on the compiler.

This means the definition

#define CONST_VALUE 5

is the only way to define a constant value which can not be modified by any means.

5
  • 10
    Modifying a constant value using a pointer is undefined behavior. If you're willing to go there, #define can also be modified, by editing the machine code.
    – ugoren
    Jun 12, 2013 at 13:57
  • You're partly right. I tested the code with Visual Studio 2012 and it prints 5. But one can't modify #define because it's a preprocessor macro. It doesn't exist in the binary program. If one wanted to modify all places where CONST_VALUE was used, one had to do it one by one. Oct 19, 2013 at 7:28
  • 3
    @ugoren: Suppose you write #define CONST 5, then if (CONST == 5) { do_this(); } else { do_that(); }, and the compiler eliminates the else branch. How do you propose to edit the machine code to change CONST to 6? Feb 26, 2014 at 16:47
  • @KeithThompson, I never said it can be done easily and reliably. Just that #define isn't bullet-proof.
    – ugoren
    Feb 26, 2014 at 18:12
  • 3
    @ugoren: My point is that "editing the machine code" is not a sensible way to duplicate the effect of changing the value of a #define. The only real way to do that is to edit the source code and recompile. Feb 26, 2014 at 19:04
5

Although the question was about integers, it's worth noting that #define and enums are useless if you need a constant structure or string. These are both usually passed to functions as pointers. (With strings it's required; with structures it's much more efficient.)

As for integers, if you're in an embedded environment with very limited memory, you might need to worry about where the constant is stored and how accesses to it are compiled. The compiler might add two consts at run time, but add two #defines at compile time. A #define constant may be converted into one or more MOV [immediate] instructions, which means the constant is effectively stored in program memory. A const constant will usually be stored in a separate section in data memory such as .const or .rodata. In systems with a Harvard architecture, there could be differences in performance and memory usage, although they'd likely be small. They might matter for hard-core optimization of inner loops.

2
  • Re ".const section in data memory.": That seems to be system-specific. What system? What assembler? Aug 13 at 19:19
  • I've seen it in TI's compiler and GCC, and it seems to be common on other platforms as well. I've changed the sentence to specify that this is an example, not a universal rule.
    – Adam Haun
    Aug 14 at 15:41
3

Don't think there's an answer for "which is always best" but, as Matthieu said

static const

is type safe. My biggest pet peeve with #define, though, is when debugging in Visual Studio you cannot watch the variable. It gives an error that the symbol cannot be found.

1
  • 1
    "you cannot watch the variable" Right, it isn't a variable. It doesn't change, why do you need to watch it? You can find everywhere it's used simply by searching for the label. Why would you need (or even want) to watch a #define? Jul 23, 2018 at 18:44
2

Incidentally, an alternative to #define, which provides proper scoping but behaves like a "real" constant, is "enum". For example:

enum {number_ten = 10};

In many cases, it's useful to define enumerated types and create variables of those types; if that is done, debuggers may be able to display variables according to their enumeration name.

One important caveat with doing that, however: in C++, enumerated types have limited compatibility with integers. For example, by default, one cannot perform arithmetic upon them. I find that to be a curious default behavior for enums; while it would have been nice to have a "strict enum" type, given the desire to have C++ generally compatible with C, I would think the default behavior of an "enum" type should be interchangeable with integers.

8
  • 1
    In C, enumeration constants are always of type int, so the "enum hack" can't be used with other integer types. (The enumeration type is compatible with some implementation-defined integer type, not necessarily int, but in this case the type is anonymous so that doesn't matter.) Feb 26, 2014 at 16:49
  • @KeithThompson: Since I wrote the above, I've read that MISRA-C will squawk if a compiler assigns a type other than int to an enumeration-typed variable (which compilers are allowed to do) and one tries to assign to such a variable a member of its own enumeration. I wish standards committees would add portable ways of declaring integer types with specified semantics. ANY platform, regardless of char size, should be able to e.g. declare a type which will wrap mod 65536, even if the compiler has to add lots of AND R0,#0xFFFF or equivalent instructions.
    – supercat
    Feb 26, 2014 at 17:09
  • You can use uint16_t, though of course that's not an enumeration type. It would be nice to let the user specify the integer type used to represent a given enumeration type, but you can achieve much of the same effect with a typedef for uint16_t and a series of #defines for individual values. Feb 26, 2014 at 17:12
  • 1
    @KeithThompson: I understand that for historical reasons, we're stuck with the fact that some platforms will evaluate 2U < -1L as true and others as false, and we're now stuck with the fact that a some platforms will implement a comparison between uint32_t and int32_t as signed and some as unsigned, but that doesn't mean the Committee couldn't define an upwardly-compatible successor to C that includes types whose semantics would be consistent on all compilers.
    – supercat
    Feb 26, 2014 at 17:16
  • @KeithThompson Thankfully C23 has now added the ability to explicitly specify the base type of an enum, for example enum : unsigned char { DEL = 127 };. It has also borrowed constexpr from C++, for example constexpr unsigned char DEL = 127; Jul 7 at 6:39
1

A simple difference:

At pre-processing time, the constant is replaced with its value. So you could not apply the dereference operator to a define, but you can apply the dereference operator to a variable.

As you would suppose, define is faster that static const.

For example, having:

#define mymax 100

you can not do printf("address of constant is %p",&mymax);.

But having

const int mymax_var=100

you can do printf("address of constant is %p",&mymax_var);.

To be more clear, the define is replaced by its value at the pre-processing stage, so we do not have any variable stored in the program. We have just the code from the text segment of the program where the define was used.

However, for static const we have a variable that is allocated somewhere. For gcc, static const are allocated in the text segment of the program.

Above, I wanted to tell about the reference operator so replace dereference with reference.

1
  • 1
    Your answer is very wrong. This is about C, your answer relates to C++, which has very different semantics for the const qualifier. C does not have symbolica constants other than enum-constants. A const int is a variable. You also confuse language and specific implementations. There is no requirement where to place the object. And it is not even true for gcc: typically it places const qualified variables in the .rodata section. But that depends on the target platform. And you mean the address-of operator &. Mar 5, 2017 at 7:13
0

We looked at the produced assembler code on the MBF16X... Both variants result in the same code for arithmetic operations (ADD Immediate, for example).

So const int is preferred for the type check while #define is old style. Maybe it is compiler-specific. So check your produced assembler code.

-2

I am not sure if I am right, but in my opinion calling #defined value is much faster than calling any other normally declared variable (or const value).

It's because when program is running and it needs to use some normally declared variable, it needs to jump to exact place in memory to get that variable.

In opposite, when it uses #defined value, the program doesn't need to jump to any allocated memory; it just takes the value. If #define myValue 7 and the program calling myValue, it behaves exactly the same as when it just calls 7.

2
  • 1
    can you please quantify the statement that it is faster? Have you profiled this in some way? at what point it it faster - compile time? linking? at runtime? On what systems and compilers? Aug 3, 2022 at 9:25
  • Actually as I told on beginning "I am not sure if I am right but in my opinion...". I'd rather expect any verification from more experienced users.
    – pajczur
    Aug 29, 2022 at 21:29

Not the answer you're looking for? Browse other questions tagged or ask your own question.