Struct matrix_sdk::event_cache::paginator::Paginator

pub struct Paginator { /* private fields */ }

A stateful object to reach to an event, and then paginate backward and forward from it.

See also the module-level documentation.

Implementations

impl Paginator

pub fn new(room: Box<dyn PaginableRoom>) -> Self

Create a new Paginator, given a room implementation.

pub fn state(&self) -> Subscriber<PaginatorState>

Returns a subscriber to the internal PaginatorState machine.

pub async fn start_from( &self, event_id: &EventId, num_events: UInt ) -> Result<StartFromResult, PaginatorError>

Starts the pagination from the initial event, requesting num_events additional context events.

Only works for fresh Paginator objects, which are in the PaginatorState::Initial state.

pub async fn paginate_backward( &self, num_events: UInt ) -> Result<PaginationResult, PaginatorError>

Runs a backward pagination (requesting num_events to the server), from the current state of the object.

Will return immediately if we have already hit the start of the timeline.

May return an error if it’s already paginating, or if the call to /messages failed.

pub async fn paginate_forward( &self, num_events: UInt ) -> Result<PaginationResult, PaginatorError>

Runs a forward pagination (requesting num_events to the server), from the current state of the object.

Will return immediately if we have already hit the end of the timeline.

May return an error if it’s already paginating, or if the call to /messages failed.

Trait Implementations

impl Debug for Paginator

Available on non-tarpaulin_include only.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.