CeresEngine::AppleRunLoop::Executor Class Reference

An executor object that dispatches calls to the CoreFoundation CFRunLoop. More...

#include <CeresEngine/Platform/Apple/AppleRunLoop.hpp>

Public Member Functions
	Executor (const Executor &)=default
Executor &	operator= (const Executor &)=default
	Executor (Executor &&)=default
Executor &	operator= (Executor &&)=default
AppleRunLoop &	context () const noexcept
	Obtain the underlying execution context.
void	on_work_started () const noexcept
	Inform the executor that it has some outstanding work to do.
void	on_work_finished () const noexcept
	Inform the executor that some work is no longer outstanding.

Private Member Functions
	Executor (AppleRunLoop *const executionContext, ExecutorBlocking blockingProperty=ExecutorBlocking::never)
	Creates a new Executor instance.
AppleRunLoop &	query (ExecutorExecutionContext) const noexcept
	Query the current value of the context property.
ExecutorBlocking	query (ExecutorBlocking) const noexcept
	Query the current value of the blocking property.
std::size_t	query (ExecutorOccupancy) const noexcept
	Query the occupancy (recommended number of work items) for the system context.
template<typename OtherAllocator >
std::allocator< void >	query (ExecutorAllocator< OtherAllocator >) const noexcept
	Query the current value of the allocator property.
std::allocator< void >	query (ExecutorAllocator< void >) const noexcept
	Query the current value of the allocator property.
Executor	require (ExecutorBlocking blocking) const
	Obtain an executor with the given blocking property.
template<typename Function >
void	execute (ASIO_MOVE_ARG(Function) f) const
	Execution function.

Static Private Member Functions
static constexpr ExecutorMapping	query (ExecutorMapping) noexcept
	Query the current value of the mapping property.
static constexpr ExecutorRelationship	query (ExecutorRelationship) noexcept
	Query the current value of the relationship property.
static constexpr ExecutorOutstandingWork	query (ExecutorOutstandingWork) noexcept
	Query the current value of the outstanding_work property.
static constexpr ExecutorBulkGuarantee	query (ExecutorBulkGuarantee) noexcept
	Query the current value of the bulk_guarantee property.

Private Attributes
AppleRunLoop *	mExecutionContext
	The execution context that the executor will use.
ExecutorBlocking	mBlockingProperty = ExecutorBlocking::never
	A property that customizes the blocking behavior of the executor.

Friends
class	AppleRunLoop
struct	asio_query_fn::impl
struct	asio::execution::detail::context_t< 0 >
struct	asio::execution::detail::mapping_t< 0 >
struct	asio::execution::detail::blocking_t< 0 >
struct	asio::execution::detail::relationship_t< 0 >
struct	asio::execution::detail::outstanding_work_t< 0 >
struct	asio::execution::detail::bulk_guarantee_t< 0 >
struct	asio::execution::detail::occupancy_t< 0 >
struct	asio_require_fn::impl
struct	asio_prefer_fn::impl
struct	asio_execution_execute_fn::impl
bool	operator== (const Executor &, const Executor &) noexcept
	Compare two executors for equality.
bool	operator!= (const Executor &, const Executor &) noexcept
	Compare two executors for inequality.

Detailed Description

An executor object that dispatches calls to the CoreFoundation CFRunLoop.

Constructor & Destructor Documentation

Executor() [1/3]

CeresEngine::AppleRunLoop::Executor::Executor ( AppleRunLoop *const  executionContext, ExecutorBlocking  blockingProperty = ExecutorBlocking::never  )

inlineexplicitprivate

Creates a new Executor instance.

Parameters

executionContext	The owning execution context.
blockingProperty	A property that customizes the blocking behavior of the executor.

Executor() [2/3]

CeresEngine::AppleRunLoop::Executor::Executor ( const Executor &  )

default

Executor() [3/3]

CeresEngine::AppleRunLoop::Executor::Executor ( Executor &&  )

default

Member Function Documentation

context()

AppleRunLoop & CeresEngine::AppleRunLoop::Executor::context ( ) const

inlinenoexcept

Obtain the underlying execution context.

execute()

template<typename Function >

void CeresEngine::AppleRunLoop::Executor::execute ( ASIO_MOVE_ARG(Function)  f ) const

inlineprivate

Execution function.

on_work_finished()

void CeresEngine::AppleRunLoop::Executor::on_work_finished ( ) const

inlinenoexcept

Inform the executor that some work is no longer outstanding.

on_work_started()

void CeresEngine::AppleRunLoop::Executor::on_work_started ( ) const

inlinenoexcept

Inform the executor that it has some outstanding work to do.

operator=() [1/2]

Executor & CeresEngine::AppleRunLoop::Executor::operator= ( const Executor &  )

default

operator=() [2/2]

Executor & CeresEngine::AppleRunLoop::Executor::operator= ( Executor &&  )

default

query() [1/9]

template<typename OtherAllocator >

std::allocator< void > CeresEngine::AppleRunLoop::Executor::query ( ExecutorAllocator< OtherAllocator >  ) const

inlineprivatenoexcept

Query the current value of the allocator property.

query() [2/9]

std::allocator< void > CeresEngine::AppleRunLoop::Executor::query ( ExecutorAllocator< void >  ) const

inlineprivatenoexcept

Query the current value of the allocator property.

query() [3/9]

ExecutorBlocking CeresEngine::AppleRunLoop::Executor::query ( ExecutorBlocking  ) const

inlineprivatenoexcept

Query the current value of the blocking property.

query() [4/9]

static constexpr ExecutorBulkGuarantee CeresEngine::AppleRunLoop::Executor::query ( ExecutorBulkGuarantee  )

inlinestaticconstexprprivatenoexcept

Query the current value of the bulk_guarantee property.

query() [5/9]

AppleRunLoop & CeresEngine::AppleRunLoop::Executor::query ( ExecutorExecutionContext  ) const

inlineprivatenoexcept

Query the current value of the context property.

query() [6/9]

static constexpr ExecutorMapping CeresEngine::AppleRunLoop::Executor::query ( ExecutorMapping  )

inlinestaticconstexprprivatenoexcept

Query the current value of the mapping property.

query() [7/9]

std::size_t CeresEngine::AppleRunLoop::Executor::query ( ExecutorOccupancy  ) const

inlineprivatenoexcept

Query the occupancy (recommended number of work items) for the system context.

query() [8/9]

static constexpr ExecutorOutstandingWork CeresEngine::AppleRunLoop::Executor::query ( ExecutorOutstandingWork  )

inlinestaticconstexprprivatenoexcept

Query the current value of the outstanding_work property.

query() [9/9]

static constexpr ExecutorRelationship CeresEngine::AppleRunLoop::Executor::query ( ExecutorRelationship  )

inlinestaticconstexprprivatenoexcept

Query the current value of the relationship property.

require()

Executor CeresEngine::AppleRunLoop::Executor::require ( ExecutorBlocking  blocking ) const

inlineprivate

Obtain an executor with the given blocking property.

Do not call this function directly. It is intended for use with the require customisation point.

For example:

auto ex1 = threadPool.getExecutor();
auto ex2 = require(ex1, ExecutorBlockingProperty::possibly);

Friends And Related Symbol Documentation

AppleRunLoop

friend class AppleRunLoop

friend

asio::execution::detail::blocking_t< 0 >

friend struct asio::execution::detail::blocking_t< 0 >

friend

asio::execution::detail::bulk_guarantee_t< 0 >

friend struct asio::execution::detail::bulk_guarantee_t< 0 >

friend

asio::execution::detail::context_t< 0 >

friend struct asio::execution::detail::context_t< 0 >

friend

asio::execution::detail::mapping_t< 0 >

friend struct asio::execution::detail::mapping_t< 0 >

friend

asio::execution::detail::occupancy_t< 0 >

friend struct asio::execution::detail::occupancy_t< 0 >

friend

asio::execution::detail::outstanding_work_t< 0 >

friend struct asio::execution::detail::outstanding_work_t< 0 >

friend

asio::execution::detail::relationship_t< 0 >

friend struct asio::execution::detail::relationship_t< 0 >

friend

asio_execution_execute_fn::impl

friend struct asio_execution_execute_fn::impl

friend

asio_prefer_fn::impl

friend struct asio_prefer_fn::impl

friend

asio_query_fn::impl

friend struct asio_query_fn::impl

friend

asio_require_fn::impl

friend struct asio_require_fn::impl

friend

operator!=

bool operator!= ( const Executor &  , const Executor &    )

friend

Compare two executors for inequality.

operator==

bool operator== ( const Executor &  , const Executor &    )

friend

Compare two executors for equality.

Member Data Documentation

mBlockingProperty

ExecutorBlocking CeresEngine::AppleRunLoop::Executor::mBlockingProperty = ExecutorBlocking::never

private

A property that customizes the blocking behavior of the executor.

mExecutionContext

AppleRunLoop* CeresEngine::AppleRunLoop::Executor::mExecutionContext

private

The execution context that the executor will use.

---

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

• /Users/Rogiel/Developer/CeresEngine/Engine/Sources/CeresEngine/Platform/Apple/AppleRunLoop.hpp