tarantool 11.0.0

Tarantool rust bindings
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

//! Box schema: function.
//!
//! Helpers to create and modify functions in tarantool.
//!
//! Picodata fork of tarantool has an extended range of function identifiers.
//! The first 32_000 identifiers (the maximum possible value in vanilla tarantool)
//! are reserved for local functions. The rest of the identifiers (up to i32::MAX)
//! are used for SQL procedures in picodata.

use crate::error::{Error, TarantoolError};
use crate::ffi::tarantool::box_generate_func_id;

fn next_id(use_reserved_range: bool) -> Result<u32, Error> {
    unsafe {
        let mut id: u32 = 0;
        let res = box_generate_func_id(&mut id, use_reserved_range);
        if res != 0 {
            return Err(TarantoolError::last().into());
        }
        Ok(id)
    }
}

/// Generate next function id from reserved range
/// (used for stored procedures in picodata).
pub fn func_next_reserved_id() -> Result<u32, Error> {
    next_id(true)
}

/// Generate next function id from default range
/// (used for local tarantool functions).
pub fn func_next_id() -> Result<u32, Error> {
    next_id(false)
}

#[cfg(feature = "internal_test")]
mod tests {
    use super::*;
    use std::convert::TryInto;

    #[crate::test(tarantool = "crate")]
    pub fn test_func_next_id() {
        let id = func_next_id().unwrap();
        assert!(id > 0 && id <= 32_000);
    }

    #[crate::test(tarantool = "crate")]
    pub fn test_func_next_reserved_id() {
        let id = func_next_reserved_id().unwrap();
        assert!(id > 32_000 && id <= i32::MAX.try_into().unwrap());
    }
}