Struct PageInfo 

#[non_exhaustive]
pub struct PageInfo {
    pub has_next: bool,
    pub has_prev: bool,
    pub next_cursor: Option<String>,
    pub prev_cursor: Option<String>,
    pub total: Option<u64>,
}

Page information for paginated responses.

Example

let page_info = PageInfo::new(20, 20)
    .with_next_cursor(Some("abc123".to_string()))
    .with_prev_cursor(Some("xyz789".to_string()))
    .with_total(100);

assert!(page_info.has_next);
assert!(page_info.has_prev);
assert_eq!(page_info.total, Some(100));

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

has_next: bool

Whether there are more items after this page.

has_prev: bool

Whether there are items before this page.

next_cursor: Option<String>

Cursor to fetch the next page.

prev_cursor: Option<String>

Cursor to fetch the previous page.

total: Option<u64>

Total count (if available).

Implementations

impl PageInfo

pub const fn new(count: usize, limit: usize) -> Self

Create page info based on returned count vs requested limit.

If count >= limit, assumes there are more items.

pub const fn with_has_prev(self, has_prev: bool) -> Self

Set whether there are previous items.

pub fn with_next_cursor(self, cursor: Option<String>) -> Self

Set the next cursor.

pub fn with_prev_cursor(self, cursor: Option<String>) -> Self

Set the previous cursor.

pub const fn with_total(self, total: u64) -> Self

Set the total count.

pub fn cursor_from<T, F>(item: Option<&T>, builder: F) -> Option<String>

where F: FnOnce(&T) -> Cursor,

Create cursor from the last item using a builder function.

Trait Implementations

impl Clone for PageInfo

fn clone(&self) -> PageInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PageInfo

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

Formats the value using the given formatter.

impl Default for PageInfo

fn default() -> PageInfo

Returns the “default value” for a type.

impl PartialEq for PageInfo

fn eq(&self, other: &PageInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PageInfo

impl StructuralPartialEq for PageInfo