载入中...
搜索中...
未找到
eve::container 命名空间参考

类

struct  Box3D
 Axis-aligned 3D box for World3DSpace zones. 更多...
 
class  Capacity
 Non-negative capacity measured in membership slots. 更多...
 
struct  Circle
 Circle public API. 更多...
 
struct  ContainerDescriptor
 Static metadata and acceptance policy of a container. 更多...
 
class  ContainerId
 Strong identity of one runtime or persistent container. 更多...
 
struct  ContainerObject
 Generic object facts used by filters and transfer diagnostics. 更多...
 
struct  ContainerObjectPayload
 Opaque, owning payload supplied by a domain adapter during transfer. 更多...
 
struct  ContainerSnapshot
 Lossless snapshot of one container at one revision. 更多...
 
struct  Coordinate
 Coordinate public API. 更多...
 
struct  Coordinate< World3DSpace >
 Three-dimensional coordinate; z is intentionally mandatory. 更多...
 
class  Filter
 Extensible filter result used by container and zone acceptance rules. 更多...
 
struct  GridSpace
 GridSpace public API. 更多...
 
class  IContainer
 Borrowed container implementation owned by a domain adapter. 更多...
 
struct  Membership
 One object-to-slot relationship, including the observed generation. 更多...
 
struct  MembershipEntry
 Complete adapter-owned state used to build a candidate replacement. 更多...
 
class  MembershipId
 Strong identity of an object which can have one container membership. 更多...
 
struct  Rectangle
 Rectangle public API. 更多...
 
struct  ScreenSpace
 Coordinate-space tags; distinct types prevent accidental mixing. 更多...
 
class  SlotIndex
 Explicit slot number; it never implicitly converts to an integer. 更多...
 
struct  Sphere3D
 Spherical 3D shape for World3DSpace zones. 更多...
 
struct  TransferEvent
 Strong event payload emitted only after a transfer is fully committed. 更多...
 
struct  TransferReceipt
 Observable receipt for one committed or explicit no-op transfer. 更多...
 
struct  TransferRequest
 Requested optimistic-concurrency transfer. All pointers are borrowed. 更多...
 
class  TransferService
 Atomic preflight/prepare/commit coordinator for one or two adapters. 更多...
 
struct  World2DSpace
 World2DSpace public API. 更多...
 
struct  World3DSpace
 World3DSpace public API. 更多...
 
class  Zone
 Shape-bounded, capacity-limited zone in one compile-time coordinate space. 更多...
 
struct  ZoneShapeTraits
 ZoneShapeTraits public API. 更多...
 
struct  ZoneShapeTraits< World3DSpace >
 ZoneShapeTraits public API. 更多...
 

类型定义

using GameEventSink = std::function< void(const game_event::GameEvent &)>
 Callback receiving a canonical game_event envelope.
 
using TransferEventSink = std::function< void(const TransferEvent &)>
 Synchronous callback receiving a committed transfer payload.
 
template<class Space >
using ZoneShape = typename ZoneShapeTraits< Space >::type
 
using AcceptedCondition = Filter
 Accepted-condition callback for a zone, shared with container filters.
 

枚举

enum class  Ordering : std::uint8_t {
  Unordered , Insertion , Stack , Queue ,
  ExplicitSlots
}
 Stable order semantics owned by a container adapter. 更多...
 
enum class  ContainerEventKind : std::uint8_t { Enter , Exit , Accepted , Rejected }
 Lifecycle outcome represented by every container-domain event. 更多...
 

函数

const char * containerEventTypeName (ContainerEventKind kind) noexcept
 Stable event type spelling shared by all container adapters.
 
EventId deterministicContainerEventId (const ContainerId &container, const MembershipId &object, ContainerEventKind kind, std::uint64_t serial) noexcept
 Derives a deterministic event identity for an adapter lifecycle event.
 

变量

constexpr std::string_view containerEventSchemaName = "container:event"
 Canonical schema name for container lifecycle envelopes.
 

类型定义说明

◆ AcceptedCondition

Accepted-condition callback for a zone, shared with container filters.

在文件 Container.h 第 465 行定义.

◆ GameEventSink

using eve::container::GameEventSink = typedef std::function<void(const game_event::GameEvent&)>

Callback receiving a canonical game_event envelope.

The forward declaration keeps the common layer independent of the game_event implementation. Adapters that emit events include game_event/GameEvent.h in their implementation file and must provide a fully populated game_event::GameEvent.

备注
Callbacks are observational, synchronous and non-owning. They must not retain the envelope reference, throw, or re-enter the emitting adapter.

在文件 Container.h 第 245 行定义.

◆ TransferEventSink

using eve::container::TransferEventSink = typedef std::function<void(const TransferEvent&)>

Synchronous callback receiving a committed transfer payload.

备注
This is an observational callback: it must not throw, re-enter TransferService, or mutate either participating container. A throwing callback is caught and reported as a warning after the transfer has already committed.

在文件 Container.h 第 351 行定义.

◆ ZoneShape

template<class Space >
using eve::container::ZoneShape = typedef typename ZoneShapeTraits<Space>::type

在文件 Container.h 第 462 行定义.

枚举类型说明

◆ ContainerEventKind

enum class eve::container::ContainerEventKind : std::uint8_t
strong

Lifecycle outcome represented by every container-domain event.

枚举值
Enter 
Exit 
Accepted 
Rejected 

在文件 Container.h 第 205 行定义.

◆ Ordering

enum class eve::container::Ordering : std::uint8_t
strong

Stable order semantics owned by a container adapter.

枚举值
Unordered 
Insertion 
Stack 
Queue 
ExplicitSlots 

在文件 Container.h 第 108 行定义.

函数说明

◆ containerEventTypeName()

const char * eve::container::containerEventTypeName ( ContainerEventKind  kind)
inlinenoexcept

Stable event type spelling shared by all container adapters.

返回
Borrowed, non-null, null-terminated static text for kind. @ownership Borrowed; the returned string is not allocated and must not be freed. @nullable No; unknown enum values return the static unknown spelling. @lifetime Static for the process lifetime. @thread Thread-safe and side-effect free. @reentrancy Does not invoke callbacks or mutate container state.

在文件 Container.h 第 221 行定义.

引用了 Accepted, Enter, Exit, kind , 以及 Rejected.

被这些函数引用 deterministicContainerEventId().

◆ deterministicContainerEventId()

EventId eve::container::deterministicContainerEventId ( const ContainerId &  container,
const MembershipId &  object,
ContainerEventKind  kind,
std::uint64_t  serial 
)
inlinenoexcept

Derives a deterministic event identity for an adapter lifecycle event.

参数
containerStable container identity.
objectStable member identity, possibly empty for malformed input.
kindLifecycle event kind.
serialAdapter-local monotonically increasing attempt serial.
返回
A non-nil domain-separated EventId.
备注
This is identity derivation, not gameplay randomness. The serial is owned by the adapter and is not persisted as membership state.

Event id.

在文件 Container.h 第 257 行定义.

引用了 bytes, containerEventTypeName(), first, index, kind, second, serial, text , 以及 value.

变量说明

◆ containerEventSchemaName

constexpr std::string_view eve::container::containerEventSchemaName = "container:event"
inlineconstexpr

Canonical schema name for container lifecycle envelopes.

在文件 Container.h 第 232 行定义.