diesel/sqlite/connection/
serialized_database.rs

Help
1#![allow(unsafe_code)]
2extern crate libsqlite3_sys as ffi;
3
4use std::ops::Deref;
5
6/// `SerializedDatabase` is a wrapper for a serialized database that is dynamically allocated by calling `sqlite3_serialize`.
7/// This RAII wrapper is necessary to deallocate the memory when it goes out of scope with `sqlite3_free`.
8#[derive(Debug)]
9pub struct SerializedDatabase {
10    data: *mut u8,
11    len: usize,
12}
13
14impl SerializedDatabase {
15    /// Creates a new `SerializedDatabase` with the given data pointer and length.
16    ///
17    /// SAFETY: The data pointer needs to be returned by sqlite
18    ///         and the length must match the underlying buffer pointer
19    pub(crate) unsafe fn new(data: *mut u8, len: usize) -> Self {
20        Self { data, len }
21    }
22
23    /// Returns a slice of the serialized database.
24    pub fn as_slice(&self) -> &[u8] {
25        // The pointer is never null because we don't pass the NO_COPY flag
26        unsafe { std::slice::from_raw_parts(self.data, self.len) }
27    }
28}
29
30impl Deref for SerializedDatabase {
31    type Target = [u8];
32
33    fn deref(&self) -> &Self::Target {
34        self.as_slice()
35    }
36}
37
38impl Drop for SerializedDatabase {
39    /// Deallocates the memory of the serialized database when it goes out of scope.
40    fn drop(&mut self) {
41        unsafe {
42            ffi::sqlite3_free(self.data as _);
43        }
44    }
45}
diesel/sqlite/connection/serialized_database.rs

diesel/sqlite/connection/
serialized_database.rs
