Curiously recurring template pattern

<h2 id="history">History</h2>
The technique was formalized in 1989 as "F-bounded quantification."<a class="footnote-ref" id="fnref:2" href="#fn:2">2</a> The name "CRTP" was independently coined by <a href="/facts/Jim_Coplien/ycnwLozX">Jim Coplien</a> in 1995,<a class="footnote-ref" id="fnref:3" href="#fn:3">3</a> who had observed it in some of the earliest <a href="/facts/C%252B%252B/Et0F2qn9">C++</a> template code as well as in code examples that Timothy Budd created in his multiparadigm language Leda.<a class="footnote-ref" id="fnref:4" href="#fn:4">4</a> It is sometimes called "Upside-Down Inheritance"<a class="footnote-ref" id="fnref:5" href="#fn:5">5</a><a class="footnote-ref" id="fnref:6" href="#fn:6">6</a> due to the way it allows class hierarchies to be extended by substituting different base classes.
The Microsoft Implementation of CRTP in <a href="/facts/Active_Template_Library/e0U99NMS">Active Template Library</a> (ATL) was independently discovered, also in 1995, by Jan Falkin, who accidentally derived a base class from a derived class. Christian Beaumont first saw Falkin's code and initially thought it could not compile in the Microsoft compiler available at the time. Following the revelation that it did work, Beaumont based the entire ATL and <a href="/facts/Windows_Template_Library/u5V4oKl8">Windows Template Library</a> (WTL) design on this mistake.

<h2 id="general-form">General form</h2>
// The Curiously Recurring Template Pattern (CRTP)
template <class T>
class Base
{
 // methods within Base can use template to access members of Derived
};
class Derived : public Base<Derived>
{
 // ...
};

Some use cases for this pattern are <a href="/facts/Template_metaprogramming/yybwJ7AN">static polymorphism</a> and other metaprogramming techniques such as those described by <a href="/facts/Andrei_Alexandrescu/4rzNtl54">Andrei Alexandrescu</a> in <a href="/facts/Modern_C%252B%252B_Design/u7EL1aFL">Modern C++ Design</a>.<a class="footnote-ref" id="fnref:7" href="#fn:7">7</a>
It also figures prominently in the C++ implementation of the <a href="/facts/Data%2c_Context%2c_and_Interaction/gw4d9A1C">Data, Context, and Interaction</a> paradigm.<a class="footnote-ref" id="fnref:8" href="#fn:8">8</a>
In addition, CRTP is used by the C++ standard library to implement the std::enable_shared_from_this functionality.<a class="footnote-ref" id="fnref:9" href="#fn:9">9</a>

<h2 id="static-polymorphism">Static polymorphism</h2>
Typically, the base class template will take advantage of the fact that member function bodies (definitions) are not instantiated until long after their declarations, and will use members of the derived class within its own member functions, via the use of a <a href="/facts/Type_conversion/FuPD945T">cast</a>; e.g.:

template <class T> 
struct Base
{
 void interface()
 {
 // ...
 static_cast<T*>(this)->implementation();
 // ...
 }

static void static_func()
    {
        // ...
        T::static_sub_func();
        // ...
    }
};

struct Derived : public Base<Derived>
{
 void implementation();
 static void static_sub_func();
};

In the above example, the function Base<Derived>::interface(), though declared before the existence of the struct Derived is known by the compiler (i.e., before Derived is declared), is not actually instantiated by the compiler until it is actually called by some later code which occurs after the declaration of Derived (not shown in the above example), so that at the time the function "interface" is instantiated, the declaration of Derived::implementation() is known.
This technique achieves a similar effect to the use of <a href="/facts/Virtual_function/cnxckyHy">virtual functions</a>, without the costs (and some flexibility) of <a href="/facts/Dynamic_polymorphism/HbBx9mpM">dynamic polymorphism</a>. This particular use of the CRTP has been called "simulated dynamic binding" by some.<a class="footnote-ref" id="fnref:10" href="#fn:10">10</a> This pattern is used extensively in the Windows <a href="/facts/Active_Template_Library/e0U99NMS">ATL</a> and <a href="/facts/Windows_Template_Library/u5V4oKl8">WTL</a> libraries.
To elaborate on the above example, consider a base class with no virtual functions. Whenever the base class calls another member function, it will always call its own base class functions. When we derive a class from this base class, we inherit all the member variables and member functions that were not overridden (no constructors or destructors). If the derived class calls an inherited function which then calls another member function, then that function will never call any derived or overridden member functions in the derived class.
However, if base class member functions use CRTP for all member function calls, the overridden functions in the derived class will be selected at compile time. This effectively emulates the virtual function call system at compile time without the costs in size or function call overhead (<a href="/facts/Virtual_method_table/rFISodUl">VTBL</a> structures, and method lookups, multiple-inheritance VTBL machinery) at the disadvantage of not being able to make this choice at runtime.

<h2 id="object-counter">Object counter</h2>
The main purpose of an object counter is retrieving statistics of object creation and destruction for a given class.<a class="footnote-ref" id="fnref:11" href="#fn:11">11</a> This can be easily solved using CRTP:

template <typename T>
struct counter
{
 static inline int objects_created = 0;
 static inline int objects_alive = 0;

counter()
    {
        ++objects_created;
        ++objects_alive;
    }
    
    counter(const counter&)
    {
        ++objects_created;
        ++objects_alive;
    }
protected:
    ~counter() // objects should never be removed through pointers of this type
    {
        --objects_alive;
    }
};

class X : counter<X>
{
 // ...
};

class Y : counter<Y>
{
 // ...
};

Each time an object of class X is created, the constructor of counter<X> is called, incrementing both the created and alive count. Each time an object of class X is destroyed, the alive count is decremented. It is important to note that counter<X> and counter<Y> are two separate classes and this is why they will keep separate counts of Xs and Ys. In this example of CRTP, this distinction of classes is the only use of the template parameter (T in counter<T>) and the reason why we cannot use a simple un-templated base class.

<h2 id="polymorphic-chaining">Polymorphic chaining</h2>
<a href="/facts/Method_chaining/1yKJJ9MA">Method chaining</a>, also known as named parameter idiom, is a common syntax for invoking multiple method calls in object-oriented programming languages. Each method returns an object, allowing the calls to be chained together in a single statement without requiring variables to store the intermediate results.
When the named parameter object pattern is applied to an object hierarchy, things can go wrong. Suppose we have such a base class:

class Printer
{
public:
 Printer(ostream& pstream) : m_stream(pstream) {}
 
 template <typename T>
 Printer& print(T&& t) { m_stream << t; return *this; }
 
 template <typename T>
 Printer& println(T&& t) { m_stream << t << endl; return *this; }
private:
 ostream& m_stream;
};

Prints can be easily chained:

Printer(myStream).println("hello").println(500);

However, if we define the following derived class:

class CoutPrinter : public Printer
{
public:
 CoutPrinter() : Printer(cout) {}

CoutPrinter& SetConsoleColor(Color c)
    {
        // ...
        return *this;
    }
};

we "lose" the concrete class as soon as we invoke a function of the base:

// v----- we have a 'Printer' here, not a 'CoutPrinter'
CoutPrinter().print("Hello ").SetConsoleColor(Color.red).println("Printer!"); // compile error

This happens because 'print' is a function of the base – 'Printer' – and then it returns a 'Printer' instance.
The CRTP can be used to avoid such problem and to implement "Polymorphic chaining":<a class="footnote-ref" id="fnref:12" href="#fn:12">12</a>

// Base class
template <typename ConcretePrinter>
class Printer
{
public:
 Printer(ostream& pstream) : m_stream(pstream) {}
 
 template <typename T>
 ConcretePrinter& print(T&& t)
 {
 m_stream << t;
 return static_cast<ConcretePrinter&>(*this);
 }
 
 template <typename T>
 ConcretePrinter& println(T&& t)
 {
 m_stream << t << endl;
 return static_cast<ConcretePrinter&>(*this);
 }
private:
 ostream& m_stream;
};
 
// Derived class
class CoutPrinter : public Printer<CoutPrinter>
{
public:
 CoutPrinter() : Printer(cout) {}
 
 CoutPrinter& SetConsoleColor(Color c)
 {
 // ...
 return *this;
 }
};
 
// usage
CoutPrinter().print("Hello ").SetConsoleColor(Color.red).println("Printer!");

<h2 id="polymorphic-copy-construction">Polymorphic copy construction</h2>
When using polymorphism, one sometimes needs to create copies of objects by the base class pointer. A commonly used idiom for this is adding a virtual clone function that is defined in every derived class. The CRTP can be used to avoid having to duplicate that function or other similar functions in every derived class.

// Base class has a pure virtual function for cloning
class AbstractShape {
public:
 virtual ~AbstractShape () = default;
 virtual std::unique_ptr<AbstractShape> clone() const = 0;
};

// This CRTP class implements clone() for Derived
template <typename Derived>
class Shape : public AbstractShape {
public:
 std::unique_ptr<AbstractShape> clone() const override {
 return std::make_unique<Derived>(static_cast<Derived const&>(*this));
 }

protected:
   // We make clear Shape class needs to be inherited
   Shape() = default;
   Shape(const Shape&) = default;
   Shape(Shape&&) = default;
};

// Every derived class inherits from CRTP class instead of abstract class

class Square : public Shape<Square>{};

class Circle : public Shape<Circle>{};

This allows obtaining copies of squares, circles or any other shapes by shapePtr->clone().

<h3>Pitfalls</h3>
One issue with static polymorphism is that without using a general base class like AbstractShape from the above example, derived classes cannot be stored homogeneously – that is, putting different types derived from the same base class in the same container. For example, a container defined as std::vector<Shape*> does not work because Shape is not a class, but a template needing specialization. A container defined as std::vector<Shape<Circle>*> can only store Circles, not Squares. This is because each of the classes derived from the CRTP base class Shape is a unique type. A common solution to this problem is to inherit from a shared base class with a virtual destructor, like the AbstractShape example above, allowing for the creation of a std::vector<AbstractShape*>.

<h2 id="deducing-this">Deducing this</h2>
The use of CRTP can be simplified using the <a href="/facts/C%252B%252B23/8sBupF9c">C++23</a> feature deducing this.<a class="footnote-ref" id="fnref:13" href="#fn:13">13</a><a class="footnote-ref" id="fnref:14" href="#fn:14">14</a> For the function signature_dish to call a derived member function cook_signature_dish, ChefBase needs to be a templated type and CafeChef needs to inherit from ChefBase, passing its type as the template parameter.

template <typename T>
struct ChefBase
{
 void signature_dish()
 {
 static_cast<T*>(this)->cook_signature_dish();
 }
};

struct CafeChef : ChefBase<CafeChef>
{
 void cook_signature_dish() {}
};

If explicit object parameter is used, ChefBase does not need to be templated and CafeChef can derive from ChefBase plainly. Since the self parameter is automatically deduced as the correct derived type, no casting is required.

struct ChefBase
{
 template <typename Self>
 void signature_dish(this Self&& self)
 {
 self.cook_signature_dish();
 }
};

struct CafeChef : ChefBase
{
    void cook_signature_dish() {}
};

<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/Barton%25E2%2580%2593Nackman_trick/JMRx3uGs">Barton–Nackman trick</a></li>
<li><a href="/facts/Bounded_quantification/ah38uAab">F-bounded quantification</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1">Abrahams, David; Gurtovoy, Aleksey (January 2005). C++ Template Metaprogramming: Concepts, Tools, and Techniques from Boost and Beyond. Addison-Wesley. ISBN 0-321-22725-5. <a href="0-321-22725-5" target="_blank">0-321-22725-5</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></li>
<li id="fn:2">William Cook; et al. (1989). "F-Bounded Polymorphism for Object-Oriented Programming" (PDF). <a href="http://cs.utexas.edu/~wcook/papers/FBound89/CookFBound89.pdf" target="_blank">http://cs.utexas.edu/~wcook/papers/FBound89/CookFBound89.pdf</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></li>
<li id="fn:3">Coplien, James O. (February 1995). "Curiously Recurring Template Patterns". C++ Report: 24–27. <a href="https://drive.google.com/file/d/1yJPlJ2d_79gxEzicliT_M2Qn2dwOfCOP/view" target="_blank">https://drive.google.com/file/d/1yJPlJ2d_79gxEzicliT_M2Qn2dwOfCOP/view</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></li>
<li id="fn:4">Budd, Timothy (1994). Multiparadigm programming in Leda. Addison-Wesley. ISBN 0-201-82080-3. <a href="0-201-82080-3" target="_blank">0-201-82080-3</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></li>
<li id="fn:5">"Apostate Café: ATL and Upside-Down Inheritance". 15 March 2006. Archived from the original on 15 March 2006. Retrieved 9 October 2016.{{cite web}}: CS1 maint: bot: original URL status unknown (link) <a href="https://web.archive.org/web/20060315072824/http://www.apostate.com/programming/atlupsidedown.html" target="_blank">https://web.archive.org/web/20060315072824/http://www.apostate.com/programming/atlupsidedown.html</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></li>
<li id="fn:6">"ATL and Upside-Down Inheritance". 4 June 2003. Archived from the original on 4 June 2003. Retrieved 9 October 2016.{{cite web}}: CS1 maint: bot: original URL status unknown (link) <a href="https://web.archive.org/web/20030604104137/http://archive.devx.com/free/mgznarch/vcdj/1999/julmag99/atlinherit1.asp" target="_blank">https://web.archive.org/web/20030604104137/http://archive.devx.com/free/mgznarch/vcdj/1999/julmag99/atlinherit1.asp</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></li>
<li id="fn:7">Alexandrescu, Andrei (2001). Modern C++ Design: Generic Programming and Design Patterns Applied. Addison-Wesley. ISBN 0-201-70431-5. <a href="0-201-70431-5" target="_blank">0-201-70431-5</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></li>
<li id="fn:8">Coplien, James; Bjørnvig, Gertrud (2010). Lean Architecture: for agile software development. Wiley. ISBN 978-0-470-68420-7. <a href="978-0-470-68420-7" target="_blank">978-0-470-68420-7</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></li>
<li id="fn:9">"std::enable_shared_from_this". Retrieved 22 November 2022. <a href="https://en.cppreference.com/w/cpp/memory/enable_shared_from_this" target="_blank">https://en.cppreference.com/w/cpp/memory/enable_shared_from_this</a> <a href="#fnref:9" class="footnote-back-ref">↩</a></li>
<li id="fn:10">"Simulated Dynamic Binding". 7 May 2003. Archived from the original on 9 February 2012. Retrieved 13 January 2012. <a href="https://web.archive.org/web/20120209045146/http://www.pnotepad.org/devlog/archives/000083.html" target="_blank">https://web.archive.org/web/20120209045146/http://www.pnotepad.org/devlog/archives/000083.html</a> <a href="#fnref:10" class="footnote-back-ref">↩</a></li>
<li id="fn:11">Meyers, Scott (April 1998). "Counting Objects in C++". C/C++ Users Journal. <a href="http://www.drdobbs.com/cpp/counting-objects-in-c/184403484" target="_blank">http://www.drdobbs.com/cpp/counting-objects-in-c/184403484</a> <a href="#fnref:11" class="footnote-back-ref">↩</a></li>
<li id="fn:12">Arena, Marco (29 April 2012). "Use CRTP for polymorphic chaining". Retrieved 15 March 2017. <a href="https://marcoarena.wordpress.com/2012/04/29/use-crtp-for-polymorphic-chaining/" target="_blank">https://marcoarena.wordpress.com/2012/04/29/use-crtp-for-polymorphic-chaining/</a> <a href="#fnref:12" class="footnote-back-ref">↩</a></li>
<li id="fn:13">Gašper Ažman; Sy Brand; Ben Deane; Barry Revzin (12 July 2021). "Deducing this". <a href="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p0847r7.html" target="_blank">http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p0847r7.html</a> <a href="#fnref:13" class="footnote-back-ref">↩</a></li>
<li id="fn:14">"Explicit object parameter". Retrieved 27 December 2023. <a href="https://en.cppreference.com/w/cpp/language/member_functions#Explicit_object_parameter" target="_blank">https://en.cppreference.com/w/cpp/language/member_functions#Explicit_object_parameter</a> <a href="#fnref:14" class="footnote-back-ref">↩</a></li>
</ol>

Curiously recurring template pattern open-in-new

Curiously recurring template pattern