Struct OffsetPage 

pub struct OffsetPage { /* private fields */ }

Normalized offset-page result.

Constructed only via build_page or build_offset_page — the inner fields are private to prevent hand-rolled construction. Call OffsetPage::into_parts to destructure into the four values needed to populate a proto response message.

Why a newtype?

The private constructor is the enforcement mechanism (ADR-0096 §Enforcement Level 1): call sites that expect OffsetPage cannot be satisfied with an inline-built response struct, making the canonical builder mandatory at compile time.

Implementations

impl OffsetPage

pub fn into_parts(self) -> (u64, bool, u64, u64)

Destructure into (total_count, has_more, limit, offset).

Use these values to populate the page field of a proto response:

let page = build_page(req.page.limit, req.page.offset, items.len(), total);
let (total_count, has_more, limit, offset) = page.into_parts();
response.page = SomeOffsetPageResponse { total_count, has_more, limit, offset, .. };

pub fn total_count(&self) -> u64

Total number of items across all pages.

pub fn has_more(&self) -> bool

Whether more items exist beyond this page.

pub fn limit(&self) -> u64

The effective limit used for this page (after clamping).

pub fn offset(&self) -> u64

The offset used for this page.

Trait Implementations

impl Clone for OffsetPage

fn clone(&self) -> OffsetPage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OffsetPage

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

Formats the value using the given formatter.

impl PartialEq for OffsetPage

fn eq(&self, other: &OffsetPage) -> 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 OffsetPage

impl StructuralPartialEq for OffsetPage