qubit-fs 0.2.2

Provider-neutral synchronous and asynchronous filesystem abstraction for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================

//! Optional provider optimization for bounded prefix reads.

/// A non-binding upper bound for bytes consumed by one prefix open.
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct PrefixReadHint {
    max_bytes: u64,
}

impl PrefixReadHint {
    /// Creates a hint for a positive prefix size.
    #[inline]
    pub(crate) const fn new(max_bytes: u64) -> Self {
        Self { max_bytes }
    }

    /// Returns the suggested maximum prefix size.
    #[inline]
    #[must_use]
    pub const fn max_bytes(self) -> u64 {
        self.max_bytes
    }
}