Card adapter composing the common lifecycle container with CardEffectExecutor. 更多...

#include <CardEffects.h>

Public 成员函数
eve::Result< void >	configureSettlementRules (const settlement::SettlementRuleSet &rules)
	Replace declarative rules used by subsequent card effect settlements.

eve::Result< void >	initializeTarget (CardEffectTarget target)
	Seed the domain target before the first effect is applied.

eve::Result< effects::EffectHandle >	apply (const CardEffectDefinition &definition, eve::SubjectRef subject)
	Apply one typed card effect and return its generation-qualified handle.

eve::Result< void >	remove (effects::EffectHandle handle)
	Remove one effect handle; stale handles are rejected.

eve::Result< CardEffectUpdate >	advance (const eve::SimulationStep &step)
	Advance and settle card effects atomically for one simulation step.

std::size_t	count () const noexcept
	Return the number of active card effects.

CardEffectSnapshot	snapshot () const
	Capture a deep lifecycle snapshot.

eve::Result< void >	restore (const CardEffectSnapshot &snapshot)
	Restore a snapshot and invalidate every pre-restore effect handle.

eve::Result< const effects::EffectInstance * >	resolve (effects::EffectHandle handle) const
	Resolve a live handle as a borrowed observation.

CardEffectTarget &	target () noexcept
	Return the mutable card target state owned by this adapter.

const CardEffectTarget &	target () const noexcept
	Return the read-only card target state.

详细描述

Card adapter composing the common lifecycle container with CardEffectExecutor.

在文件 CardEffects.h 第 90 行定义.

成员函数说明

◆ advance()

eve::Result< CardEffectUpdate > eve::card::CardEffectAdapter::advance ( const eve::SimulationStep & step )

Advance and settle card effects atomically for one simulation step.

在文件 CardEffects.cpp 第 273 行定义.

引用了 eve::effects::EffectExecutor::advance(), eve::Applied, eve::effects::EffectContainer::clone(), eve::Result< T >::failure(), eve::card::CardEffectExecutor::settle(), step, eve::Status::success() , 以及 eve::Result< T >::success().

◆ apply()

eve::Result< effects::EffectHandle > eve::card::CardEffectAdapter::apply	(	const CardEffectDefinition &	definition,
		eve::SubjectRef	subject
	)

Apply one typed card effect and return its generation-qualified handle.

在文件 CardEffects.cpp 第 224 行定义.

◆ configureSettlementRules()

eve::Result< void > eve::card::CardEffectAdapter::configureSettlementRules ( const settlement::SettlementRuleSet & rules )

Replace declarative rules used by subsequent card effect settlements.

返回: Applied, or a structured failure while retaining the previous rule set. @thread Call on the adapter's owning simulation thread outside advance. @reentrancy Does not invoke callbacks.

在文件 CardEffects.cpp 第 220 行定义.

引用了 eve::card::CardEffectExecutor::configureSettlementRules().

◆ count()

std::size_t eve::card::CardEffectAdapter::count ( ) const

noexcept

Return the number of active card effects.

在文件 CardEffects.cpp 第 286 行定义.

引用了 eve::effects::EffectContainer::effectCount().

◆ initializeTarget()

eve::Result< void > eve::card::CardEffectAdapter::initializeTarget ( CardEffectTarget target )

Seed the domain target before the first effect is applied.

参数

target Initial current/max health and barrier state owned by the card.

返回: Applied, or a conflict when active effects already exist.

在文件 CardEffects.cpp 第 114 行定义.

引用了 eve::Applied, eve::card::CardEffectTarget::barrier, eve::Conflict, eve::effects::EffectContainer::effectCount(), eve::Diagnostic::error(), eve::Result< T >::failure(), eve::card::CardEffectTarget::health, eve::InvalidArgument, eve::card::CardEffectTarget::maxHealth, eve::Status::success(), eve::Result< T >::success() , 以及 target().

◆ remove()

eve::Result< void > eve::card::CardEffectAdapter::remove ( effects::EffectHandle handle )

Remove one effect handle; stale handles are rejected.

在文件 CardEffects.cpp 第 267 行定义.

引用了 eve::Result< T >::failure(), handle, eve::effects::EffectContainer::remove() , 以及 eve::effects::EffectContainer::resolve().

◆ resolve()

eve::Result< const effects::EffectInstance * > eve::card::CardEffectAdapter::resolve ( effects::EffectHandle handle ) const

Resolve a live handle as a borrowed observation.

在文件 CardEffects.cpp 第 300 行定义.

引用了 handle , 以及 eve::effects::EffectContainer::resolve().

◆ restore()

eve::Result< void > eve::card::CardEffectAdapter::restore ( const CardEffectSnapshot & snapshot )

Restore a snapshot and invalidate every pre-restore effect handle.

在文件 CardEffects.cpp 第 290 行定义.

引用了 eve::Applied, eve::card::CardEffectTarget::barrier, eve::card::CardEffectSnapshot::effects, eve::Diagnostic::error(), eve::Result< T >::failure(), eve::card::CardEffectTarget::health, eve::InvalidArgument, eve::card::CardEffectTarget::maxHealth, eve::effects::EffectContainer::restore(), eve::Status::success(), eve::Result< T >::success() , 以及 eve::card::CardEffectSnapshot::target.

◆ snapshot()

CardEffectSnapshot eve::card::CardEffectAdapter::snapshot ( ) const

Capture a deep lifecycle snapshot.

在文件 CardEffects.cpp 第 288 行定义.

引用了 eve::effects::EffectContainer::snapshot().

◆ target() [1/2]

const CardEffectTarget & eve::card::CardEffectAdapter::target ( ) const

inlinenoexcept

Return the read-only card target state.

在文件 CardEffects.h 第 123 行定义.

◆ target() [2/2]

CardEffectTarget & eve::card::CardEffectAdapter::target ( )