Struct PageLayout 

pub struct PageLayout {
    page_size: NonZeroU64,
    file_size: u64,
}

Fixed-size logical byte pages within one immutable file.

Fields

page_size: NonZeroU64

file_size: u64

Implementations

impl PageLayout

pub fn new(page_size: NonZeroU64, file_size: u64) -> Self

Creates a layout. The final page is clipped to the file size.

pub fn page_ids(&self, request: Range<u64>) -> Result<Range<u64>>

Returns the half-open page-ID range intersecting a byte request.

Requests are clipped at EOF. Empty or wholly out-of-file requests return an empty range; reversed ranges are rejected. This does not allocate one entry per page, even for large files.

pub fn page_range(&self, page_id: u64) -> Option<Range<u64>>

Returns a page’s file byte range, or None for a page outside the file.

pub fn request_slice( &self, page_id: u64, request: Range<u64>, ) -> Result<Option<Range<usize>>>

Returns the requested slice relative to a page’s buffer.

Returns None if the page and request do not intersect. The caller can borrow this slice for an immediate response; caching a slice of a much larger I/O buffer may retain that entire allocation and needs a copy.

Trait Implementations

impl Clone for PageLayout

fn clone(&self) -> PageLayout

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PageLayout

impl Debug for PageLayout

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

Formats the value using the given formatter.