Struct Pager 

pub struct Pager { /* private fields */ }

A single page request resolved from an optional cursor and a page size.

Paginated tools follow a fetch-one-extra pattern: query size + 1 rows, then call Self::paginate to trim the extra row and emit a next cursor when present. Construct with Self::new; read Self::offset / Self::limit when building the SQL statement.

Implementations

impl Pager

pub fn new(cursor: Option<Cursor>, size: u16) -> Self

Builds a page request from an optional cursor and the configured page size.

pub fn offset(&self) -> i64

Row offset at which this page starts.

Returned as i64 so the value is directly bindable to sqlx LIMIT/OFFSET placeholders across every backend. Saturates at i64::MAX for cursor offsets that exceed the signed range.

pub fn limit(&self) -> i64

Row count to fetch from the backend (size + 1, for lookahead).

Returned as i64 for direct sqlx binding. Capped at u16::MAX + 1 since size is constructed from a u16.

pub fn paginate<T>(&self, items: Vec<T>) -> (Vec<T>, Option<Cursor>)

Trims over-fetched items to size and derives the next cursor.

When items.len() exceeds size, the tail is dropped and a cursor pointing at the next offset is returned. Otherwise the items are returned unchanged with None.

Trait Implementations

impl Clone for Pager

fn clone(&self) -> Pager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Pager

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

Formats the value using the given formatter.

impl Copy for Pager