rustler 0.20.0

Safe Rust wrappers for creating Erlang NIF functions
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

use super::nif_interface;
pub use super::nif_interface::ErlNifMapIterator;
use super::nif_interface::{ErlNifMapIteratorEntry, NIF_ENV, NIF_TERM};
use std::mem;

pub unsafe fn get_map_value(env: NIF_ENV, map: NIF_TERM, key: NIF_TERM) -> Option<NIF_TERM> {
    let mut result: NIF_TERM = mem::uninitialized();
    let success = nif_interface::enif_get_map_value(env, map, key, &mut result);

    if success != 1 {
        return None;
    }
    Some(result)
}

pub unsafe fn get_map_size(env: NIF_ENV, map: NIF_TERM) -> Option<usize> {
    let mut size: nif_interface::size_t = mem::uninitialized();
    let success = nif_interface::enif_get_map_size(env, map, &mut size);

    if success != 1 {
        return None;
    }
    Some(size)
}

pub unsafe fn map_new(env: NIF_ENV) -> NIF_TERM {
    nif_interface::enif_make_new_map(env)
}

pub unsafe fn map_put(
    env: NIF_ENV,
    map: NIF_TERM,
    key: NIF_TERM,
    value: NIF_TERM,
) -> Option<NIF_TERM> {
    let mut result: NIF_TERM = mem::uninitialized();
    let success = nif_interface::enif_make_map_put(env, map, key, value, &mut result);

    if success != 1 {
        return None;
    }
    Some(result)
}

pub unsafe fn map_remove(env: NIF_ENV, map: NIF_TERM, key: NIF_TERM) -> Option<NIF_TERM> {
    let mut result: NIF_TERM = mem::uninitialized();
    let success = nif_interface::enif_make_map_remove(env, map, key, &mut result);

    if success != 1 {
        return None;
    }
    Some(result)
}

pub unsafe fn map_update(
    env: NIF_ENV,
    map: NIF_TERM,
    key: NIF_TERM,
    new_value: NIF_TERM,
) -> Option<NIF_TERM> {
    let mut result: NIF_TERM = mem::uninitialized();
    let success = nif_interface::enif_make_map_update(env, map, key, new_value, &mut result);

    if success != 1 {
        return None;
    }
    Some(result)
}

pub unsafe fn map_iterator_create(env: NIF_ENV, map: NIF_TERM) -> Option<ErlNifMapIterator> {
    let mut iter = mem::uninitialized();
    let success = nif_interface::enif_map_iterator_create(
        env,
        map,
        &mut iter,
        ErlNifMapIteratorEntry::ERL_NIF_MAP_ITERATOR_HEAD,
    );
    if success == 0 {
        None
    } else {
        Some(iter)
    }
}

pub unsafe fn map_iterator_destroy(env: NIF_ENV, iter: &mut ErlNifMapIterator) {
    nif_interface::enif_map_iterator_destroy(env, iter);
}

pub unsafe fn map_iterator_get_pair(
    env: NIF_ENV,
    iter: &mut ErlNifMapIterator,
) -> Option<(NIF_TERM, NIF_TERM)> {
    let mut key: NIF_TERM = mem::uninitialized();
    let mut value: NIF_TERM = mem::uninitialized();
    if nif_interface::enif_map_iterator_get_pair(env, iter, &mut key, &mut value) == 0 {
        None
    } else {
        Some((key, value))
    }
}

pub unsafe fn map_iterator_next(env: NIF_ENV, iter: &mut ErlNifMapIterator) {
    nif_interface::enif_map_iterator_next(env, iter);
}

#[cfg(nif_version_2_14)]
pub unsafe fn make_map_from_arrays(env: NIF_ENV, keys: &[NIF_TERM], values: &[NIF_TERM]) -> Option<NIF_TERM> {
    let mut map = mem::uninitialized();
    if nif_interface::enif_make_map_from_arrays(
        env, keys.as_ptr(), values.as_ptr(), keys.len() as usize, &mut map) == 0 {
        return None;
    }

    Some(map)
}