Double-checked locking

<h2 id="motivation-and-original-pattern">Motivation and original pattern</h2>
Consider, for example, this code segment in the <a href="/facts/Java_(programming_language)/9ScgFyAL">Java programming language</a>:<a class="footnote-ref" id="fnref:5" href="#fn:5">5</a>

// Single-threaded version
class Foo {
 private static Helper helper;
 public Helper getHelper() {
 if (helper == null) {
 helper = new Helper();
 }
 return helper;
 }

// other functions and members...
}

The problem is that this does not work when using multiple threads. A <a href="/facts/Lock_(computer_science)/e3a9gnJT">lock</a> must be obtained in case two threads call getHelper() simultaneously. Otherwise, either they may both try to create the object at the same time, or one may wind up getting a reference to an incompletely initialized object.
Synchronizing with a lock can fix this, as is shown in the following example:

// Correct but possibly expensive multithreaded version
class Foo {
 private Helper helper;
 public synchronized Helper getHelper() {
 if (helper == null) {
 helper = new Helper();
 }
 return helper;
 }

// other functions and members...
}

This is correct and will most likely have sufficient performance. However, the first call to getHelper() will create the object and only the few threads trying to access it during that time need to be synchronized; after that all calls just get a reference to the member variable. Since synchronizing a method could in some extreme cases decrease performance by a factor of 100 or higher,<a class="footnote-ref" id="fnref:6" href="#fn:6">6</a> the overhead of acquiring and releasing a lock every time this method is called seems unnecessary: once the initialization has been completed, acquiring and releasing the locks would appear unnecessary. Many programmers, including the authors of the double-checked locking design pattern, have attempted to optimize this situation in the following manner:

<ol><li>Check that the variable is initialized (without obtaining the lock). If it is initialized, return it immediately.</li>
<li>Obtain the lock.</li>
<li>Double-check whether the variable has already been initialized: if another thread acquired the lock first, it may have already done the initialization. If so, return the initialized variable.</li>
<li>Otherwise, initialize and return the variable.</li></ol>
// Broken multithreaded version
// original "Double-Checked Locking" idiom
class Foo {
 private Helper helper;
 public Helper getHelper() {
 if (helper == null) {
 synchronized (this) {
 if (helper == null) {
 helper = new Helper();
 }
 }
 }
 return helper;
 }

// other functions and members...
}

Intuitively, this algorithm is an efficient solution to the problem. But if the pattern is not written carefully, it will have a <a href="/facts/Data_race/bvNpgy4F">data race</a>. For example, consider the following sequence of events:

<ol><li>Thread A notices that the value is not initialized, so it obtains the lock and begins to initialize the value.</li>
<li>Due to the semantics of some programming languages, the code generated by the compiler is allowed to update the shared variable to point to a partially constructed object before A has finished performing the initialization. For example, in Java if a call to a constructor has been inlined then the shared variable may immediately be updated once the storage has been allocated but before the inlined constructor initializes the object.<a class="footnote-ref" id="fnref:7" href="#fn:7">7</a></li>
<li>Thread B notices that the shared variable has been initialized (or so it appears), and returns its value. Because thread B believes the value is already initialized, it does not acquire the lock. If B uses the object before all of the initialization done by A is seen by B (either because A has not finished initializing it or because some of the initialized values in the object have not yet percolated to the memory B uses (<a href="/facts/Cache_coherence/MhUD576q">cache coherence</a>)), the program will likely crash.</li></ol>
Most runtimes have <a href="/facts/Memory_barrier/am65f6bs">memory barriers</a> or other methods for managing memory visibility across execution units. Without a detailed understanding of the language's behavior in this area, the algorithm is difficult to implement correctly. One of the dangers of using double-checked locking is that even a naive implementation will appear to work most of the time: it is not easy to distinguish between a correct implementation of the technique and one that has subtle problems. Depending on the <a href="/facts/Compiler/WNfCDFJe">compiler</a>, the interleaving of threads by the <a href="/facts/Scheduling_(computing)/XptmcM1a">scheduler</a> and the nature of other <a href="/facts/Concurrency_(computer_science)/Ctnrrq4A">concurrent system activity</a>, failures resulting from an incorrect implementation of double-checked locking may only occur intermittently. Reproducing the failures can be difficult.

<h2 id="usage-in-c11">Usage in C++11</h2>
For the singleton pattern, double-checked locking is not needed:

If control enters the declaration concurrently while the variable is being initialized, the concurrent execution shall wait for completion of the initialization.— § 6.7 [stmt.dcl] p4
Singleton& GetInstance() {
 static Singleton s;
 return s;
}

C++11 and beyond also provide a built-in double-checked locking pattern in the form of std::once_flag and std::call_once:

#include <mutex>
#include <optional> // Since C++17

// Singleton.h
class Singleton {
 public:
  static Singleton* GetInstance();
 private:
  Singleton() = default;

static std::optional<Singleton> s_instance;
 static std::once_flag s_flag;
};

// Singleton.cpp
std::optional<Singleton> Singleton::s_instance;
std::once_flag Singleton::s_flag{};

Singleton* Singleton::GetInstance() {
  std::call_once(Singleton::s_flag,
                 []() { s_instance.emplace(Singleton{}); });
  return &*s_instance;
}

If one truly wishes to use the double-checked idiom instead of the trivially working example above (for instance because Visual Studio before the 2015 release did not implement the C++11 standard's language about concurrent initialization quoted above <a class="footnote-ref" id="fnref:8" href="#fn:8">8</a> ), one needs to use acquire and release fences:<a class="footnote-ref" id="fnref:9" href="#fn:9">9</a>

#include <atomic>
#include <mutex>

class Singleton {
 public:
  static Singleton* GetInstance();

private:
  Singleton() = default;

static std::atomic<Singleton*> s_instance;
 static std::mutex s_mutex;
};

Singleton* Singleton::GetInstance() {
 Singleton* p = s_instance.load(std::memory_order_acquire);
 if (p == nullptr) { // 1st check
 std::lock_guard<std::mutex> lock(s_mutex);
 p = s_instance.load(std::memory_order_relaxed);
 if (p == nullptr) { // 2nd (double) check
 p = new Singleton();
 s_instance.store(p, std::memory_order_release);
 }
 }
 return p;
}

<h2 id="usage-in-posix">Usage in POSIX</h2>
<a href="https://pubs.opengroup.org/onlinepubs/7908799/xsh/pthread_once.html">pthread_once()</a>
 must be used
to initialize library (or sub-module) code when its API does not have a dedicated initialization 
procedure required to be called in single-threaded mode.

<h2 id="usage-in-go">Usage in Go</h2>
package main

import "sync"

var arrOnce sync.Once
var arr []int

// getArr retrieves arr, lazily initializing on first call. Double-checked
// locking is implemented with the sync.Once library function. The first
// goroutine to win the race to call Do() will initialize the array, while
// others will block until Do() has completed. After Do has run, only a
// single atomic comparison will be required to get the array.
func getArr() []int {
	arrOnce.Do(func() {
		arr = []int{0, 1, 2}
	})
	return arr
}

func main() {
	// thanks to double-checked locking, two goroutines attempting to getArr()
	// will not cause double-initialization
	go getArr()
	go getArr()
}

<h2 id="usage-in-java">Usage in Java</h2>
As of <a href="/facts/Java_Platform,_Standard_Edition/1HMPhdsv">J2SE 5.0</a>, the <a href="/facts/Volatile_variable/GLgsSNDB">volatile</a> keyword is defined to create a memory barrier. This allows a solution that ensures that multiple threads handle the singleton instance correctly. This new idiom is described in <a href="http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html">[3]</a> and <a href="http://www.oracle.com/technetwork/articles/javase/bloch-effective-08-qa-140880.html">[4]</a>.

// Works with acquire/release semantics for volatile in Java 1.5 and later
// Broken under Java 1.4 and earlier semantics for volatile
class Foo {
 private volatile Helper helper;
 public Helper getHelper() {
 Helper localRef = helper;
 if (localRef == null) {
 synchronized (this) {
 localRef = helper;
 if (localRef == null) {
 helper = localRef = new Helper();
 }
 }
 }
 return localRef;
 }

// other functions and members...
}

Note the local variable "localRef", which seems unnecessary. The effect of this is that in cases where helper is already initialized (i.e., most of the time), the volatile field is only accessed once (due to "return localRef;" instead of "return helper;"), which can improve the method's overall performance by as much as 40 percent.<a class="footnote-ref" id="fnref:10" href="#fn:10">10</a>
Java 9 introduced the <a href="https://docs.oracle.com/en/java/javase/19/docs/api/java.base/java/lang/invoke/VarHandle.html">VarHandle</a> class, which allows use of relaxed atomics to access fields, giving somewhat faster reads on machines with weak memory models, at the cost of more difficult mechanics and loss of sequential consistency (field accesses no longer participate in the synchronization order, the global order of accesses to volatile fields).<a class="footnote-ref" id="fnref:11" href="#fn:11">11</a>

// Works with acquire/release semantics for VarHandles introduced in Java 9
class Foo {
 private volatile Helper helper;

public Helper getHelper() {
        Helper localRef = getHelperAcquire();
        if (localRef == null) {
            synchronized (this) {
                localRef = getHelperAcquire();
                if (localRef == null) {
                    localRef = new Helper();
                    setHelperRelease(localRef);
                }
            }
        }
        return localRef;
    }

private static final VarHandle HELPER;
    private Helper getHelperAcquire() {
        return (Helper) HELPER.getAcquire(this);
    }
    private void setHelperRelease(Helper value) {
        HELPER.setRelease(this, value);
    }

static {
        try {
            MethodHandles.Lookup lookup = MethodHandles.lookup();
            HELPER = lookup.findVarHandle(Foo.class, "helper", Helper.class);
        } catch (ReflectiveOperationException e) {
            throw new ExceptionInInitializerError(e);
        }
    }

// other functions and members...
}

If the helper object is static (one per class loader), an alternative is the <a href="/facts/Initialization-on-demand_holder_idiom/shKdvXqQ">initialization-on-demand holder idiom</a><a class="footnote-ref" id="fnref:12" href="#fn:12">12</a> (See Listing 16.6<a class="footnote-ref" id="fnref:13" href="#fn:13">13</a> from the previously cited text.)

// Correct lazy initialization in Java
class Foo {
 private static class HelperHolder {
 public static final Helper helper = new Helper();
 }

public static Helper getHelper() {
        return HelperHolder.helper;
    }
}

This relies on the fact that nested classes are not loaded until they are referenced.
Semantics of final field in Java 5 can be employed to safely publish the helper object without using volatile:<a class="footnote-ref" id="fnref:14" href="#fn:14">14</a>

public class FinalWrapper<T> {
 public final T value;
 public FinalWrapper(T value) {
 this.value = value;
 }
}

public class Foo {
 private FinalWrapper<Helper> helperWrapper;

public Helper getHelper() {
 FinalWrapper<Helper> tempWrapper = helperWrapper;

if (tempWrapper == null) {
 synchronized (this) {
 if (helperWrapper == null) {
 helperWrapper = new FinalWrapper<Helper>(new Helper());
 }
 tempWrapper = helperWrapper;
 }
 }
 return tempWrapper.value;
 }
}

The local variable tempWrapper is required for correctness: simply using helperWrapper for both null checks and the return statement could fail due to read reordering allowed under the Java Memory Model.<a class="footnote-ref" id="fnref:15" href="#fn:15">15</a> Performance of this implementation is not necessarily better than the volatile implementation.

<h2 id="usage-in-c">Usage in C#</h2>
In .NET Framework 4.0, the Lazy<T> class was introduced, which internally uses double-checked locking by default (ExecutionAndPublication mode) to store either the exception that was thrown during construction, or the result of the function that was passed to Lazy<T>:<a class="footnote-ref" id="fnref:16" href="#fn:16">16</a>

public class MySingleton
{
 private static readonly Lazy<MySingleton> _mySingleton = new Lazy<MySingleton>(() => new MySingleton());

private MySingleton() { }

public static MySingleton Instance => _mySingleton.Value;
}

<h2 id="see-also">See also</h2>
<ul><li>The <a href="/facts/Test_and_Test-and-set/qIph7q7W">Test and Test-and-set</a> <a href="/facts/Programming_idiom/jgggjC2n">idiom</a> for a low-level locking mechanism.</li>
<li><a href="/facts/Initialization-on-demand_holder_idiom/shKdvXqQ">Initialization-on-demand holder idiom</a> for a thread-safe replacement in Java.</li></ul>

<h2 id="external-links">External links</h2>
<ul><li>Issues with the double checked locking mechanism captured in <a href="https://web.archive.org/web/20060620041255/http://purevirtuals.com/blog/2006/06/16/son-of-a-bug/">Jeu George's Blogs</a></li>
<li>"Double Checked Locking" Description from the Portland Pattern Repository</li>
<li>"Double Checked Locking is Broken" Description from the Portland Pattern Repository</li>
<li>Paper "<a href="http://www.aristeia.com/Papers/DDJ_Jul_Aug_2004_revised.pdf">C++ and the Perils of Double-Checked Locking</a>" (475 KB) by <a href="/facts/Scott_Meyers/7lEPrl3A">Scott Meyers</a> and <a href="/facts/Andrei_Alexandrescu/4rzNtl54">Andrei Alexandrescu</a></li>
<li>Article "<a href="https://www.infoworld.com/article/2074979/double-checked-locking--clever--but-broken.html">Double-checked locking: Clever, but broken</a>" by Brian Goetz</li>
<li>Article "<a href="https://www.infoworld.com/article/2074990/warning--threading-in-a-multiprocessor-world.html">Warning! Threading in a multiprocessor world</a>" by <a href="/facts/Allen_Holub/PTGj2vxj">Allen Holub</a></li>
<li><a href="http://www.ibm.com/developerworks/java/library/j-dcl/index.html">Double-checked locking and the Singleton pattern</a></li>
<li><a href="https://web.archive.org/web/20060412081055/http://www.oaklib.org/docs/oak/singleton.html">Singleton Pattern and Thread Safety</a></li>
<li><a href="http://msdn2.microsoft.com/en-us/library/12a04hfd.aspx">volatile keyword in VC++ 2005</a></li>
<li><a href="https://web.archive.org/web/20120902131951/https://blogs.oracle.com/cwebster/entry/double_check_locking">Java Examples and timing of double check locking solutions</a></li>
<li><a href="http://www.oracle.com/technetwork/articles/javase/bloch-effective-08-qa-140880.html">"More Effective Java With Google's Joshua Bloch"</a>.</li></ul>

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

<ol>
<li id="fn:1">Schmidt, D et al. Pattern-Oriented Software Architecture Vol 2, 2000 pp353-363 <a href="#fnref:1" class="footnote-back-ref">↩</a></li>
<li id="fn:2">Pattern languages of program design. 3 (PDF) (Nachdr. ed.). Reading, Mass: Addison-Wesley. 1998. ISBN 978-0201310115. <a href="978-0201310115" target="_blank">978-0201310115</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></li>
<li id="fn:3">Gregoire, Marc (24 February 2021). Professional C++. John Wiley & Sons. ISBN 978-1-119-69545-5. <a href="978-1-119-69545-5" target="_blank">978-1-119-69545-5</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></li>
<li id="fn:4">David Bacon et al. The "Double-Checked Locking is Broken" Declaration. <a href="http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html" target="_blank">http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></li>
<li id="fn:5">David Bacon et al. The "Double-Checked Locking is Broken" Declaration. <a href="http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html" target="_blank">http://www.cs.umd.edu/~pugh/java/memoryModel/DoubleCheckedLocking.html</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></li>
<li id="fn:6">Boehm, Hans-J (Jun 2005). "Threads cannot be implemented as a library" (PDF). ACM SIGPLAN Notices. 40 (6): 261–268. doi:10.1145/1064978.1065042. Archived from the original (PDF) on 2017-05-30. Retrieved 2014-08-12. <a href="https://web.archive.org/web/20170530160703/http://www.hpl.hp.com/techreports/2004/HPL-2004-209.pdf" target="_blank">https://web.archive.org/web/20170530160703/http://www.hpl.hp.com/techreports/2004/HPL-2004-209.pdf</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></li>
<li id="fn:7">Haggar, Peter (1 May 2002). "Double-checked locking and the Singleton pattern". IBM. Archived from the original on 2017-10-27. Retrieved 2022-05-19. <a href="https://web.archive.org/web/20171027162134/https://www.ibm.com/developerworks/java/library/j-dcl/index.html" target="_blank">https://web.archive.org/web/20171027162134/https://www.ibm.com/developerworks/java/library/j-dcl/index.html</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></li>
<li id="fn:8">"Support for C++11-14-17 Features (Modern C++)". <a href="https://msdn.microsoft.com/en-au/library/hh567368.aspx#concurrencytable" target="_blank">https://msdn.microsoft.com/en-au/library/hh567368.aspx#concurrencytable</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></li>
<li id="fn:9">Double-Checked Locking is Fixed In C++11 <a href="http://preshing.com/20130930/double-checked-locking-is-fixed-in-cpp11/" target="_blank">http://preshing.com/20130930/double-checked-locking-is-fixed-in-cpp11/</a> <a href="#fnref:9" class="footnote-back-ref">↩</a></li>
<li id="fn:10">Bloch, Joshua (2018). Effective Java (Third ed.). Addison-Wesley. p. 335. ISBN 978-0-13-468599-1. On my machine, the method above is about 1.4 times as fast as the obvious version without a local variable. <a href="978-0-13-468599-1" target="_blank">978-0-13-468599-1</a> <a href="#fnref:10" class="footnote-back-ref">↩</a></li>
<li id="fn:11">"Chapter 17. Threads and Locks". docs.oracle.com. Retrieved 2018-07-28. <a href="https://docs.oracle.com/javase/specs/jls/se10/html/jls-17.html#jls-17.4.4" target="_blank">https://docs.oracle.com/javase/specs/jls/se10/html/jls-17.html#jls-17.4.4</a> <a href="#fnref:11" class="footnote-back-ref">↩</a></li>
<li id="fn:12">Brian Goetz et al. Java Concurrency in Practice, 2006 pp348 <a href="#fnref:12" class="footnote-back-ref">↩</a></li>
<li id="fn:13">Goetz, Brian; et al. "Java Concurrency in Practice – listings on website". Retrieved 21 October 2014. <a href="http://jcip.net.s3-website-us-east-1.amazonaws.com/listings.html" target="_blank">http://jcip.net.s3-website-us-east-1.amazonaws.com/listings.html</a> <a href="#fnref:13" class="footnote-back-ref">↩</a></li>
<li id="fn:14">[1] Javamemorymodel-discussion mailing list Page not found – consider updating the link <a href="https://mailman.cs.umd.edu/mailman/private/javamemorymodel-discussion/2010-July/000422.html" target="_blank">https://mailman.cs.umd.edu/mailman/private/javamemorymodel-discussion/2010-July/000422.html</a> <a href="#fnref:14" class="footnote-back-ref">↩</a></li>
<li id="fn:15">[2] Manson, Jeremy (2008-12-14). "Date-Race-Ful Lazy Initialization for Performance – Java Concurrency (&c)". Retrieved 3 December 2016. <a href="http://jeremymanson.blogspot.ru/2008/12/benign-data-races-in-java.html" target="_blank">http://jeremymanson.blogspot.ru/2008/12/benign-data-races-in-java.html</a> <a href="#fnref:15" class="footnote-back-ref">↩</a></li>
<li id="fn:16">Albahari, Joseph (2010). "Threading in C#: Using Threads". C# 4.0 in a Nutshell. O'Reilly Media. ISBN 978-0-596-80095-6. Lazy<T> actually implements […] double-checked locking. Double-checked locking performs an additional volatile read to avoid the cost of obtaining a lock if the object is already initialized. <a href="978-0-596-80095-6" target="_blank">978-0-596-80095-6</a> <a href="#fnref:16" class="footnote-back-ref">↩</a></li>
</ol>

Double-checked locking open-in-new

Double-checked locking