Struct Page 

pub struct Page<T> {
    pub items: Vec<T>,
    pub page: u64,
    pub per_page: u64,
    pub total_items: u64,
    pub total_pages: u64,
}

A single page of offset-paginated results (LIMIT/OFFSET-style).

Fields

items: Vec<T>

page: u64

1-based page number.

per_page: u64

total_items: u64

total_pages: u64

0 when total_items is 0; otherwise ceil(total_items / per_page).

Implementations

impl<T> Page<T>

pub fn new(items: Vec<T>, page: u64, per_page: u64, total_items: u64) -> Self

Builds a page, computing total_pages from total_items and per_page. page and per_page are clamped to a minimum of 1.

pub fn has_next(&self) -> bool

true if page is before total_pages.

pub fn has_prev(&self) -> bool

true if page is after 1.

pub fn next_page(&self) -> Option<u64>

pub fn prev_page(&self) -> Option<u64>

pub fn map<U>(self, f: impl FnMut(T) -> U) -> Page<U>

Maps items through f, leaving all pagination metadata unchanged — e.g. to turn a Page<UserRow> into a Page<UserDto> before serializing.

pub fn link_header(&self, base_url: &str) -> Option<String>

Builds an RFC 8288 Link header value with rel="first", "prev", "next", and "last" entries as applicable (a first page omits first/prev; a last page omits next/last). page/per_page query parameters are added to (or overwritten on) base_url, and any other existing query parameters are preserved.

Returns None if base_url fails to parse, or if there is nothing to link to (a single page with no prev/next).

Trait Implementations

impl<T: Clone> Clone for Page<T>

fn clone(&self) -> Page<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Page<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for Page<T>

fn eq(&self, other: &Page<T>) -> 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<T: PartialEq> StructuralPartialEq for Page<T>