Struct ChunkRequestHandle 

pub struct ChunkRequestHandle {
    inner: Option<ChunkRequestInner>,
}

Handle for a ticketed chunk request.

Dropping or cancelling the handle releases its tickets. The handle never creates chunk holders directly; lifecycle publication remains owned by the game-tick boundary.

Fields

inner: Option<ChunkRequestInner>

Implementations

impl ChunkRequestHandle

pub(crate) fn new(chunk_map: Arc<ChunkMap>, request: ChunkRequest) -> Self

fn new_with_ticket( chunk_map: Arc<ChunkMap>, request: ChunkRequest, ticket: ChunkTicket, ) -> Self

pub fn status(&self) -> Option<ChunkStatus>

Returns the requested status, if this handle is still active.

pub fn ticket_kind(&self) -> Option<ChunkTicketKind>

Returns the ticket kind, if this handle is still active.

pub fn positions(&self) -> &[ChunkPos]

Returns requested positions after deduplication.

pub fn poll(&self) -> ChunkRequestState

Polls request readiness. Chunk holder creation and generation scheduling are owned by the chunk scheduling epochs.

pub fn ready_chunks(&self) -> Option<ReadyChunks>

Returns holders once every requested chunk is at the target status.

pub fn cancel(&mut self)

Cancels the request and releases its tickets.

fn release_tickets(&mut self)

Trait Implementations

impl Drop for ChunkRequestHandle

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.