Struct Range 

pub struct Range {
    pub offset: i64,
    pub limit_to: Option<i64>,
}

A non-negative range representing rows to return.

A non-negative range for pagination. Uses Option<i64> for boundaries where None means unbounded.

Fields

offset: i64

Lower bound (0-based, inclusive). Always present.

limit_to: Option<i64>

Upper bound (inclusive). None means unbounded (all remaining rows).

Implementations

impl Range

pub fn all() -> Self

Create a range representing all rows (offset=0, unbounded).

pub fn new(offset: i64, limit_to: i64) -> Self

Create a range from offset to upper bound (inclusive).

pub fn from_offset(offset: i64) -> Self

Create a range starting at the given offset with no upper bound.

pub fn limit_zero() -> Self

The special limit-zero range (0 <= x <= -1). Used to allow limit=0 queries per the API spec.

pub fn has_limit_zero(&self) -> bool

Check if this is the limit-zero range.

pub fn limit(&self) -> Option<i64>

Get the number of rows this range covers, if bounded.

pub fn offset(&self) -> i64

Get the offset.

pub fn is_all(&self) -> bool

Check if this range is unbounded (no upper limit).

pub fn is_empty_range(&self) -> bool

Check if this range is empty (lower > upper).

pub fn restrict(&self, max_rows: Option<i64>) -> Self

Restrict this range by applying a limit.

If max_rows is Some, ensures the range covers at most that many rows.

pub fn with_limit(&self, limit: i64) -> Self

Apply a limit (number of rows).

pub fn with_offset(&self, offset: i64) -> Self

Apply an offset.

pub fn intersect(&self, other: &Range) -> Self

Intersect this range with another.

pub fn convert_to_limit_zero(&self, fallback: &Range) -> Self

Convert to limit-zero range if it has limit=0, else use fallback.

Trait Implementations

impl Clone for Range

fn clone(&self) -> Range

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Range

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

Formats the value using the given formatter.

impl Default for Range

fn default() -> Self

The default range: all rows starting from 0.

impl<'de> Deserialize<'de> for Range

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Range

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

Formats the value using the given formatter.

impl PartialEq for Range

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Range

impl Eq for Range

impl StructuralPartialEq for Range