How to have static data members in a header-only library?

by

C++17 and above

Use inline static variables for non-dynamic initialization:

struct Foo
{
    inline static int I = 0;
};

And use function local static variables otherwise:

struct Foo
{
    static std::string& Bar()
    {
        static std::string S = compute();
        return S;
    }
};

C++14 and below

Use function local statics, as they are plain easier to use.

If for some reason you really wish for a static data member, then you can use the template trick:

template <typename T = void>
struct Foo
{
     static int I = 0; // inline initialization only for simple types.
};

template <typename T>
int Foo<T>::I;

On local statics

For resources which require dynamic initialization, it is best to use a local static.

The order in which file-scope or class-scope statics are dynamically initialized is undefined, in general, leading to the Static Initialization Order Fiasco when you try to read a uninitialized static as part of the initialization of another. Local static solve the issue by being initialized lazily, on first use.

There is some slight overhead to using local statics, however. From C++11 onwards, the initialization is required to be thread-safe, which typically means that any access is gated by an atomic read and well-predicted branch.

More Related Contents:

  1. How to initialize private static members in C++?
  2. Undefined reference to static constexpr char[]
  3. C++ Static member initialization (template fun inside)
  4. c++ access static members using null pointer
  5. How to force a static member to be initialized?
  6. Constant expression initializer for static class member of type double
  7. constexpr initializing static member using static function
  8. Benefits of header-only libraries
  9. static vs extern “C”/”C++”
  10. Static member access in constant expressions
  11. What does “typedef void (*Something)()” mean
  12. Why is a class allowed to have a static member of itself, but not a non-static member?
  13. static variable in the class declaration or definition?
  14. Why does constexpr static member (of type class) require a definition?
  15. What am I allowed to do with a static, constexpr, in-class initialized data member?
  16. How to initialize static members in the header
  17. C++ static variable in .lib does not initialize
  18. CMake: target_include_directories() prints an error when I try to add the source directory itself, or one of its subdirectories
  19. C++ if statement/xcode [closed]
  20. What are the evaluation order guarantees introduced by C++17?
  21. std::string formatting like sprintf
  22. Is Meyers’ implementation of the Singleton pattern thread safe?
  23. Is ncurses available for windows? [closed]
  24. Why use functors over functions?
  25. Implementing SSE 4.2’s CRC32C in software
  26. What are the signs of crosses initialization?
  27. How to include omp.h in OS X?
  28. How do I erase elements from STL containers?
  29. std::getline() reads carriage return \r into the string, how to avoid that?
  30. using extern template (C++11) to avoid instantiation

Leave a Comment