hicc

A Rust FFI SDK that easily and efficiently enables the calling of any c++ api function, while significantly increasing the memory safety of c++ api interfaces.

    --------                ---------------------------        ------------------              --------
    | rust | ---rust api---| c++ abi declare with rust |       | c++ abi declare |---c++ api---| c++  |
    -------                 ---------------------------        ------------------              --------
                                          |                             |
                                 -----------------               ---------------
                                 | hicc rust sdk |-----c abi-----| hicc c++ sdk |
                                 -----------------        |      ---------------
                                                          |                     
                                 -----------------        |
                                 | hicc js sdk   | --------
                                 -----------------

支持的功能介绍

支持的数据类型.

说明:

1. rust侧忽略volatile.

支持的函数类型.

安全性保证和增强

基于rust生命周期机制，可增强c++接口的安全性.

c++容器的迭代器是一个典型的例子.

template<class T, class Allocator> class vector {
    //...
    iterator begin();
};

可映射为如下rust接口:

hicc::import_class! {
    pub class vector<T> {
        // ...
        fn begin(&mut self) -> &mut VecIter<T>;
    }
    pub class VecIter<T> {
        //...
    }
}

迭代器和容器的生命周期关联起来，基于rust的借用规则，增强了接口的安全性.

开发指南.

详细内容参见cargo doc生成的文档.

可参考examples目录下的样例，模板类可参考hicc-std的实现.

约束: 依赖c++11及更高版本的特性.