What’s the C++ idiom equivalent to the Java static block?

by

You can have static blocks in C++ as well – outside classes.

It turns out we can implement a Java-style static block, albeit outside of a class rather than inside it, i.e. at translation unit scope. The implementation is a bit ugly under the hood, but when used it’s quite elegant!

Downloadable version

There’s now a GitHub repo for the solution, containing a single header file: static_block.hpp.

Usage

If you write:

static_block {
    std::cout << "Hello static block world!\n";
}

this code will run before your main(). And you can initialize static variables or do whatever else you like. So you can place such a block in your class’ .cpp implementation file.

Notes:

  • You must surround your static block code with curly braces.
  • The relative order of execution of static code is not guaranteed in C++.

Implementation

The static block implementation involves a dummy variable initialized statically with a function. Your static block is actually the body of that function. To ensure we don’t collide with some other dummy variable (e.g. from another static block – or anywhere else), we need a bit of macro machinery.

#define CONCATENATE(s1, s2) s1##s2
#define EXPAND_THEN_CONCATENATE(s1, s2) CONCATENATE(s1, s2)
#ifdef __COUNTER__
#define UNIQUE_IDENTIFIER(prefix) EXPAND_THEN_CONCATENATE(prefix, __COUNTER__)
#else
#define UNIQUE_IDENTIFIER(prefix) EXPAND_THEN_CONCATENATE(prefix, __LINE__)
#endif // __COUNTER__
#ifdef _MSC_VER
#define _UNUSED
#else
#define _UNUSED __attribute((unused))
#endif // _MSC_VER

and here is the macro work to put things together:

#define static_block STATIC_BLOCK_IMPL1(UNIQUE_IDENTIFIER(_static_block_))

#define STATIC_BLOCK_IMPL1(prefix) \
    STATIC_BLOCK_IMPL2(CONCATENATE(prefix,_fn),CONCATENATE(prefix,_var))

#define STATIC_BLOCK_IMPL2(function_name,var_name) \
static void function_name(); \
static int var_name _UNUSED = (function_name(), 0) ; \
static void function_name()

Notes:

  • Some compilers do not support __COUNTER__ – it’s not part of the C++ standard; in those cases the code above uses __LINE__, which works too. GCC and Clang do support __COUNTER__.
  • This is C++98; you don’t need any C++11/14/17 constructs. However, it’s not valid C, despite not using any classes or methods.
  • The __attribute ((unused)) might be dropped, or replaced with [[unused]] if you have a C++11 compiler which doesn’t like the GCC-style unused extension.
  • This does not avert or help with the static initialization order fiasco, since while you know your static block will execute before main(), you are not guaranteed when exactly that happens relative to other static initializations.

Live Demo

More Related Contents:

  1. Static Initialization Blocks
  2. When is the static block of a class executed?
  3. is there a Java equivalent to null coalescing operator (??) in C#? [duplicate]
  4. Why doesn’t this Java code do the same as this C++ code? (basic operations; C++ output is correct) [closed]
  5. C++ code to Java, few questions [closed]
  6. Why is it considered a bad practice to omit curly braces? [closed]
  7. Real World Example of the Strategy Pattern
  8. Are there C++ equivalents for the Protocol Buffers delimited I/O functions in Java?
  9. Default values and initialization in Java
  10. Is there a Java equivalent or methodology for the typedef keyword in C++?
  11. Access private field of another object in same class
  12. Embed Java into a C++ application?
  13. What are the differences between “generic” types in C++ and Java?
  14. What does the registerNatives() method do?
  15. Uninitialized Object vs Object Initialized to NULL
  16. Equivalent function to C’s “_getch()” in Java?
  17. How should I write the .i file to wrap callbacks in Java or C#
  18. Does java really have pointers or not? [closed]
  19. How does subtracting the character ‘0’ from a char change it into an int?
  20. Java – C-Like Fork?
  21. Can the char type be categorized as an integer?
  22. Why we use if, else if instead of multiple if block if the body is a return statement
  23. Port of Random generator from C to Java?
  24. Pass an array to a wrapped function as pointer+size or range
  25. What is inlining?
  26. Why NoClassDefFoundError caused by static field initialization failure?
  27. Attach to already running JVM
  28. Initialize field before super constructor runs?
  29. Finding the median value of an array?
  30. How can I perform multiplication without the ‘*’ operator?

Leave a Comment