grid-rs 0.1.0

A library for interacting with host functions in the Slipstream runtime.
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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

//! Key-value store.
//!
//! This module provides access to the host's key-value store. You should be able to manage keys,
//! values, and stores from within your functions.
//!
//! *Note:* stores are currently only available, one for each function.
use crate::region::Region;

unsafe extern "C" {
    fn kv_get(key_ptr: usize) -> usize;
    fn kv_put(key_ptr: usize, value_ptr: usize);
    fn kv_delete(key_ptr: usize);
    fn kv_delete_store();
    fn kv_commit();
}

/// Key-value storage endpoints.
#[derive(Default)]
pub struct Storage;

impl Storage {
    /// Get a value from the key-value store.
    pub fn get(key: &str) -> Option<Vec<u8>> {
        let key = Region::build(key.as_bytes());
        let key_ptr = &*key as *const Region;

        let value_ptr = unsafe { kv_get(key_ptr as usize) };
        if value_ptr == 0 {
            return None;
        }

        unsafe { Some(Region::consume(value_ptr as *mut Region)) }
    }

    /// Put a value into the key-value store.
    pub fn put(key: &str, value: &[u8]) {
        let key = Region::build(key.as_bytes());
        let key_ptr = &*key as *const Region;
        let value = Region::build(value);
        let value_ptr = &*value as *const Region;

        unsafe { kv_put(key_ptr as usize, value_ptr as usize) };
    }

    /// Delete a value from the key-value store.
    pub fn delete(key: &str) {
        let key = Region::build(key.as_bytes());
        let key_ptr = &*key as *const Region;

        unsafe { kv_delete(key_ptr as usize) };
    }

    /// Delete the entire key-value store.
    pub fn delete_store() {
        unsafe { kv_delete_store() };
    }

    /// Persist the key-value store to the host storage.
    pub fn commit() {
        unsafe { kv_commit() };
    }
}