Service locator, nothing more. More...

#include <locator.hpp>

Public Types
using	type = Service
	Service type.
using	node_type = service_handle
	Service node type.

Public Member Functions
	locator ()=delete
	Default constructor, deleted on purpose.
	locator (const locator &)=delete
	Default copy constructor, deleted on purpose.
	~locator ()=delete
	Default destructor, deleted on purpose.
locator &	operator= (const locator &)=delete
	Default copy assignment operator, deleted on purpose.

Static Public Member Functions
static bool	has_value () noexcept
	Checks whether a service locator contains a value.
static Service &	value () noexcept
	Returns a reference to a valid service, if any.
template<stl::derived_from< Service > Type = Service, typename... Args> requires stl::constructible_from<Type, Args...>
static Service &	value_or (Args &&...args)
	Returns a service if available or sets it from a fallback type.
template<stl::derived_from< Service > Type = Service, typename... Args> requires stl::constructible_from<Type, Args...>
static Service &	emplace (Args &&...args)
	Sets or replaces a service.
template<stl::derived_from< Service > Type = Service, typename... Args> requires stl::constructible_from<Type, Args...>
static Service &	emplace (stl::allocator_arg_t, auto alloc, Args &&...args)
	Sets or replaces a service using a given allocator.
static node_type	handle () noexcept
	Returns a handle to the underlying service.
static void	reset (const node_type &other={}) noexcept
	Resets or replaces a service.
template<stl::derived_from< Service > Type, typename Deleter = stl::default_delete<Type>>
static void	reset (Type *elem, Deleter deleter={})
	Resets or replaces a service.

Detailed Description

template<typename Service>
class entt::locator< Service >

Service locator, nothing more.

A service locator is used to do what it promises: locate services.
Usually service locators are tightly bound to the services they expose and thus it's hard to define a general purpose class to do that. This tiny class tries to fill the gap and to get rid of the burden of defining a different specific locator for each application.

Note: Users shouldn't retain references to a service. The recommended way is to retrieve the service implementation currently set each and every time the need for it arises. The risk is to incur in unexpected behaviors otherwise.

Template Parameters

Service Service type.

Definition at line 28 of file locator.hpp.

Member Typedef Documentation

◆ node_type

template<typename Service>

using entt::locator< Service >::node_type = service_handle

Service node type.

Definition at line 38 of file locator.hpp.

◆ type

template<typename Service>

using entt::locator< Service >::type = Service

Service type.

Definition at line 36 of file locator.hpp.

Member Function Documentation

◆ emplace() [1/2]

template<typename Service>

template<stl::derived_from< Service > Type = Service, typename... Args>
requires stl::constructible_from<Type, Args...>

Service & entt::locator< Service >::emplace ( Args &&... args )

inlinestatic

Sets or replaces a service.

Template Parameters

Type	Service type.
Args	Types of arguments to use to construct the service.

Parameters

args	Parameters to use to construct the service.

Returns: A reference to a valid service.

Definition at line 103 of file locator.hpp.

◆ emplace() [2/2]

template<typename Service>

template<stl::derived_from< Service > Type = Service, typename... Args>
requires stl::constructible_from<Type, Args...>

Service & entt::locator< Service >::emplace	(	stl::allocator_arg_t	,
		auto	alloc,
		Args &&...	args )

inlinestatic

Sets or replaces a service using a given allocator.

Template Parameters

Type	Service type.
Args	Types of arguments to use to construct the service.

Parameters

alloc	The allocator to use.
args	Parameters to use to construct the service.

Returns: A reference to a valid service.

Definition at line 118 of file locator.hpp.

◆ handle()

template<typename Service>

node_type entt::locator< Service >::handle ( )

inlinestaticnoexcept

Returns a handle to the underlying service.

Returns: A handle to the underlying service.

Definition at line 127 of file locator.hpp.

◆ has_value()

template<typename Service>

bool entt::locator< Service >::has_value ( )

inlinestaticnodiscardnoexcept

Checks whether a service locator contains a value.

Returns: True if the service locator contains a value, false otherwise.

Definition at line 59 of file locator.hpp.

◆ operator=()

template<typename Service>

locator & entt::locator< Service >::operator= ( const locator< Service > & )

delete

Default copy assignment operator, deleted on purpose.

Returns: This locator.

◆ reset() [1/2]

template<typename Service>

void entt::locator< Service >::reset ( const node_type & other = {} )

inlinestaticnoexcept

Resets or replaces a service.

Parameters

other Optional handle with which to replace the service.

Definition at line 137 of file locator.hpp.

◆ reset() [2/2]

template<typename Service>

template<stl::derived_from< Service > Type, typename Deleter = stl::default_delete<Type>>

void entt::locator< Service >::reset	(	Type *	elem,
		Deleter	deleter = {} )

inlinestatic

Resets or replaces a service.

Template Parameters

Type	Service type.
Deleter	Deleter type.

Parameters

elem	A pointer to a service to manage.
deleter	A deleter to use to destroy the service.

Definition at line 149 of file locator.hpp.

◆ value()

template<typename Service>

Service & entt::locator< Service >::value ( )

inlinestaticnodiscardnoexcept

Returns a reference to a valid service, if any.

Warning: Invoking this function can result in undefined behavior if the service hasn't been set yet.

Returns: A reference to the service currently set, if any.

Definition at line 72 of file locator.hpp.

◆ value_or()

template<typename Service>

template<stl::derived_from< Service > Type = Service, typename... Args>
requires stl::constructible_from<Type, Args...>

Service & entt::locator< Service >::value_or ( Args &&... args )

inlinestaticnodiscard

Returns a service if available or sets it from a fallback type.

Arguments are used only if a service doesn't already exist. In all other cases, they are discarded.

Template Parameters

Args	Types of arguments to use to construct the fallback service.
Type	Fallback service type.

Parameters

args	Parameters to use to construct the fallback service.

Returns: A reference to a valid service.

Definition at line 90 of file locator.hpp.

The documentation for this class was generated from the following file:

src/entt/locator/locator.hpp

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ node_type

◆ type

Member Function Documentation

◆ emplace() [1/2]

◆ emplace() [2/2]

◆ handle()

◆ has_value()

◆ operator=()

◆ reset() [1/2]

◆ reset() [2/2]

◆ value()

◆ value_or()