EnTT 3.13.0
Loading...
Searching...
No Matches
locator.hpp
1#ifndef ENTT_LOCATOR_LOCATOR_HPP
2#define ENTT_LOCATOR_LOCATOR_HPP
3
4#include <memory>
5#include <utility>
6#include "../config/config.h"
7
8namespace entt {
9
26template<typename Service>
27class locator final {
28 class service_handle {
29 friend class locator<Service>;
30 std::shared_ptr<Service> value{};
31 };
32
33public:
35 using type = Service;
37 using node_type = service_handle;
38
40 locator() = delete;
42 ~locator() = delete;
43
48 [[nodiscard]] static bool has_value() noexcept {
49 return (service != nullptr);
50 }
51
61 [[nodiscard]] static Service &value() noexcept {
62 ENTT_ASSERT(has_value(), "Service not available");
63 return *service;
64 }
65
77 template<typename Type = Service, typename... Args>
78 [[nodiscard]] static Service &value_or(Args &&...args) {
79 return service ? *service : emplace<Type>(std::forward<Args>(args)...);
80 }
81
89 template<typename Type = Service, typename... Args>
90 static Service &emplace(Args &&...args) {
91 service = std::make_shared<Type>(std::forward<Args>(args)...);
92 return *service;
93 }
94
104 template<typename Type = Service, typename Allocator, typename... Args>
105 static Service &emplace(std::allocator_arg_t, Allocator alloc, Args &&...args) {
106 service = std::allocate_shared<Type>(alloc, std::forward<Args>(args)...);
107 return *service;
108 }
109
114 static node_type handle() noexcept {
115 node_type node{};
116 node.value = service;
117 return node;
118 }
119
124 static void reset(const node_type &other = {}) noexcept {
125 service = other.value;
126 }
127
135 template<typename Type, typename Deleter = std::default_delete<Type>>
136 static void reset(Type *elem, Deleter deleter = {}) {
137 service = std::shared_ptr<Service>{elem, std::move(deleter)};
138 }
139
140private:
141 // std::shared_ptr because of its type erased allocator which is useful here
142 inline static std::shared_ptr<Service> service{};
143};
144
145} // namespace entt
146
147#endif
Service locator, nothing more.
Definition locator.hpp:27
static node_type handle() noexcept
Returns a handle to the underlying service.
Definition locator.hpp:114
static void reset(Type *elem, Deleter deleter={})
Resets or replaces a service.
Definition locator.hpp:136
static Service & emplace(std::allocator_arg_t, Allocator alloc, Args &&...args)
Sets or replaces a service using a given allocator.
Definition locator.hpp:105
static void reset(const node_type &other={}) noexcept
Resets or replaces a service.
Definition locator.hpp:124
static Service & value() noexcept
Returns a reference to a valid service, if any.
Definition locator.hpp:61
static bool has_value() noexcept
Checks whether a service locator contains a value.
Definition locator.hpp:48
service_handle node_type
Service node type.
Definition locator.hpp:37
~locator()=delete
Default destructor, deleted on purpose.
Service type
Service type.
Definition locator.hpp:35
static Service & value_or(Args &&...args)
Returns a service if available or sets it from a fallback type.
Definition locator.hpp:78
locator()=delete
Default constructor, deleted on purpose.
static Service & emplace(Args &&...args)
Sets or replaces a service.
Definition locator.hpp:90
EnTT default namespace.
Definition dense_map.hpp:21