Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(300)

Unified Diff: src/lazy-instance.h

Issue 316133002: Move atomic ops and related files to base library (Closed) Base URL: https://v8.googlecode.com/svn/branches/bleeding_edge
Patch Set: updates Created 6 years, 6 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « src/isolate.cc ('k') | src/mark-compact.cc » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: src/lazy-instance.h
diff --git a/src/lazy-instance.h b/src/lazy-instance.h
deleted file mode 100644
index e353362f286b761c17c07b3b9b4e158dcc41ed51..0000000000000000000000000000000000000000
--- a/src/lazy-instance.h
+++ /dev/null
@@ -1,237 +0,0 @@
-// Copyright 2012 the V8 project authors. All rights reserved.
-// Use of this source code is governed by a BSD-style license that can be
-// found in the LICENSE file.
-
-// The LazyInstance<Type, Traits> class manages a single instance of Type,
-// which will be lazily created on the first time it's accessed. This class is
-// useful for places you would normally use a function-level static, but you
-// need to have guaranteed thread-safety. The Type constructor will only ever
-// be called once, even if two threads are racing to create the object. Get()
-// and Pointer() will always return the same, completely initialized instance.
-//
-// LazyInstance is completely thread safe, assuming that you create it safely.
-// The class was designed to be POD initialized, so it shouldn't require a
-// static constructor. It really only makes sense to declare a LazyInstance as
-// a global variable using the LAZY_INSTANCE_INITIALIZER initializer.
-//
-// LazyInstance is similar to Singleton, except it does not have the singleton
-// property. You can have multiple LazyInstance's of the same type, and each
-// will manage a unique instance. It also preallocates the space for Type, as
-// to avoid allocating the Type instance on the heap. This may help with the
-// performance of creating the instance, and reducing heap fragmentation. This
-// requires that Type be a complete type so we can determine the size. See
-// notes for advanced users below for more explanations.
-//
-// Example usage:
-// static LazyInstance<MyClass>::type my_instance = LAZY_INSTANCE_INITIALIZER;
-// void SomeMethod() {
-// my_instance.Get().SomeMethod(); // MyClass::SomeMethod()
-//
-// MyClass* ptr = my_instance.Pointer();
-// ptr->DoDoDo(); // MyClass::DoDoDo
-// }
-//
-// Additionally you can override the way your instance is constructed by
-// providing your own trait:
-// Example usage:
-// struct MyCreateTrait {
-// static void Construct(MyClass* allocated_ptr) {
-// new (allocated_ptr) MyClass(/* extra parameters... */);
-// }
-// };
-// static LazyInstance<MyClass, MyCreateTrait>::type my_instance =
-// LAZY_INSTANCE_INITIALIZER;
-//
-// WARNINGS:
-// - This implementation of LazyInstance IS THREAD-SAFE by default. See
-// SingleThreadInitOnceTrait if you don't care about thread safety.
-// - Lazy initialization comes with a cost. Make sure that you don't use it on
-// critical path. Consider adding your initialization code to a function
-// which is explicitly called once.
-//
-// Notes for advanced users:
-// LazyInstance can actually be used in two different ways:
-//
-// - "Static mode" which is the default mode since it is the most efficient
-// (no extra heap allocation). In this mode, the instance is statically
-// allocated (stored in the global data section at compile time).
-// The macro LAZY_STATIC_INSTANCE_INITIALIZER (= LAZY_INSTANCE_INITIALIZER)
-// must be used to initialize static lazy instances.
-//
-// - "Dynamic mode". In this mode, the instance is dynamically allocated and
-// constructed (using new) by default. This mode is useful if you have to
-// deal with some code already allocating the instance for you (e.g.
-// OS::Mutex() which returns a new private OS-dependent subclass of Mutex).
-// The macro LAZY_DYNAMIC_INSTANCE_INITIALIZER must be used to initialize
-// dynamic lazy instances.
-
-#ifndef V8_LAZY_INSTANCE_H_
-#define V8_LAZY_INSTANCE_H_
-
-#include "src/base/macros.h"
-#include "src/once.h"
-
-namespace v8 {
-namespace internal {
-
-#define LAZY_STATIC_INSTANCE_INITIALIZER { V8_ONCE_INIT, { {} } }
-#define LAZY_DYNAMIC_INSTANCE_INITIALIZER { V8_ONCE_INIT, 0 }
-
-// Default to static mode.
-#define LAZY_INSTANCE_INITIALIZER LAZY_STATIC_INSTANCE_INITIALIZER
-
-
-template <typename T>
-struct LeakyInstanceTrait {
- static void Destroy(T* /* instance */) {}
-};
-
-
-// Traits that define how an instance is allocated and accessed.
-
-
-template <typename T>
-struct StaticallyAllocatedInstanceTrait {
- // 16-byte alignment fallback to be on the safe side here.
- struct V8_ALIGNAS(T, 16) StorageType {
- char x[sizeof(T)];
- };
-
- STATIC_ASSERT(V8_ALIGNOF(StorageType) >= V8_ALIGNOF(T));
-
- static T* MutableInstance(StorageType* storage) {
- return reinterpret_cast<T*>(storage);
- }
-
- template <typename ConstructTrait>
- static void InitStorageUsingTrait(StorageType* storage) {
- ConstructTrait::Construct(MutableInstance(storage));
- }
-};
-
-
-template <typename T>
-struct DynamicallyAllocatedInstanceTrait {
- typedef T* StorageType;
-
- static T* MutableInstance(StorageType* storage) {
- return *storage;
- }
-
- template <typename CreateTrait>
- static void InitStorageUsingTrait(StorageType* storage) {
- *storage = CreateTrait::Create();
- }
-};
-
-
-template <typename T>
-struct DefaultConstructTrait {
- // Constructs the provided object which was already allocated.
- static void Construct(T* allocated_ptr) {
- new(allocated_ptr) T();
- }
-};
-
-
-template <typename T>
-struct DefaultCreateTrait {
- static T* Create() {
- return new T();
- }
-};
-
-
-struct ThreadSafeInitOnceTrait {
- template <typename Function, typename Storage>
- static void Init(OnceType* once, Function function, Storage storage) {
- CallOnce(once, function, storage);
- }
-};
-
-
-// Initialization trait for users who don't care about thread-safety.
-struct SingleThreadInitOnceTrait {
- template <typename Function, typename Storage>
- static void Init(OnceType* once, Function function, Storage storage) {
- if (*once == ONCE_STATE_UNINITIALIZED) {
- function(storage);
- *once = ONCE_STATE_DONE;
- }
- }
-};
-
-
-// TODO(pliard): Handle instances destruction (using global destructors).
-template <typename T, typename AllocationTrait, typename CreateTrait,
- typename InitOnceTrait, typename DestroyTrait /* not used yet. */>
-struct LazyInstanceImpl {
- public:
- typedef typename AllocationTrait::StorageType StorageType;
-
- private:
- static void InitInstance(StorageType* storage) {
- AllocationTrait::template InitStorageUsingTrait<CreateTrait>(storage);
- }
-
- void Init() const {
- InitOnceTrait::Init(
- &once_,
- // Casts to void* are needed here to avoid breaking strict aliasing
- // rules.
- reinterpret_cast<void(*)(void*)>(&InitInstance), // NOLINT
- reinterpret_cast<void*>(&storage_));
- }
-
- public:
- T* Pointer() {
- Init();
- return AllocationTrait::MutableInstance(&storage_);
- }
-
- const T& Get() const {
- Init();
- return *AllocationTrait::MutableInstance(&storage_);
- }
-
- mutable OnceType once_;
- // Note that the previous field, OnceType, is an AtomicWord which guarantees
- // 4-byte alignment of the storage field below. If compiling with GCC (>4.2),
- // the LAZY_ALIGN macro above will guarantee correctness for any alignment.
- mutable StorageType storage_;
-};
-
-
-template <typename T,
- typename CreateTrait = DefaultConstructTrait<T>,
- typename InitOnceTrait = ThreadSafeInitOnceTrait,
- typename DestroyTrait = LeakyInstanceTrait<T> >
-struct LazyStaticInstance {
- typedef LazyInstanceImpl<T, StaticallyAllocatedInstanceTrait<T>,
- CreateTrait, InitOnceTrait, DestroyTrait> type;
-};
-
-
-template <typename T,
- typename CreateTrait = DefaultConstructTrait<T>,
- typename InitOnceTrait = ThreadSafeInitOnceTrait,
- typename DestroyTrait = LeakyInstanceTrait<T> >
-struct LazyInstance {
- // A LazyInstance is a LazyStaticInstance.
- typedef typename LazyStaticInstance<T, CreateTrait, InitOnceTrait,
- DestroyTrait>::type type;
-};
-
-
-template <typename T,
- typename CreateTrait = DefaultCreateTrait<T>,
- typename InitOnceTrait = ThreadSafeInitOnceTrait,
- typename DestroyTrait = LeakyInstanceTrait<T> >
-struct LazyDynamicInstance {
- typedef LazyInstanceImpl<T, DynamicallyAllocatedInstanceTrait<T>,
- CreateTrait, InitOnceTrait, DestroyTrait> type;
-};
-
-} } // namespace v8::internal
-
-#endif // V8_LAZY_INSTANCE_H_
« no previous file with comments | « src/isolate.cc ('k') | src/mark-compact.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698