Method alloc_for_slice

crates/table/src/page.rs:630–638

Allocates and stores `slice` as a linked-list of granules in the var-len storage of the page. Returns a [`VarLenRef`] pointing to the head of that list, and a boolean `in_blob` for whether the allocation is a `BlobHash` and the `slice` must be inserted into the large-blob store. # Safety post-requirements The following are the safety *post-requirements* of calling this method. That is, this met

(&mut self, slice: &[u8])

    ///    has an initialized header and a data section initialized to at least
    ///    as many bytes as claimed by the header.
    pub fn alloc_for_slice(&mut self, slice: &[u8]) -> Result<(VarLenRef, bool), Error> {
        let obj_len = slice.len();
        // Safety post-requirement 2. of `alloc_for_obj_common` is already satisfied
        // as `chunks(slice)` will return sub-slices where the sum is `obj_len`.
        // Moreover, we initialize each granule already with the right data and length.
        // The requirement 1. is forwarded to the caller.
        let chunks = |_| VarLenGranule::chunks(slice).rev().map(|c| (c, c.len()));
        self.alloc_for_obj_common(obj_len, chunks)
    }

    /// Allocates for `obj_len` bytes as a linked-list of granules
    /// in the var-len storage of the page.