• 关键字 extern
• 属性 #[no_mangle]
• 外部块 ExternBlock 及其属性 link 和 link_name
• 标准库
• std:os:raw 模块
• std:ffi 模块

1. 关键字 extern

1.1 extern 函数

• extern "Rust"，默认的 ABI，在 Rust 代码中对任何普通函数fn foo()声明时都将使用该 ABI。
• extern "C"，指定使用 C-ABI，类似extern fn foo()，无论 C 编译器支持哪种默认设置。
• extern "system"，通常类似extern "C"，但在 Win32 平台上，它是"stdcall"，或用于链接到 Windows API。

// ffi/c-call-rust/src/lib.rs

pub extern "C" fn call_from_rust() {
println!("This is a Rust function for C!");
}

1.2 属性 #[no_mangle]

Undefined symbols for architecture x86_64:
"_call_from_rust", referenced from:
      _main in main-77cb59.o
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1

// ffi/c-call-rust/src/lib.rs
#[no_mangle]
pub extern "C" fn call_from_rust() {
println!("This is a Rust function for C!");
}

1.3 外部块 ExternBlock

extern Abi? {
    InnerAttribute*
    ExternalItem*
}

外部块的属性 link

• dylib，表示为动态库。如果未指定kind，则它为默认值。
• static，表示为静态库。
• framework，表示 macOS 的框架，这仅对 macOS 目标有效。

#[link(name = "c_library")]
extern "C" {
fn c_function(input: i32) -> i32;
}

外部块的属性 link_name

extern "C" {
#[link_name = "c_function_name"]
fn name_in_rust();
}

// ffi/rust-call-c/src/main.rs
// 标准库<stdlib.h>内置的abs函数
extern "C" {
#[link_name = "abs"]
fn abs_in_rust(input: i32) -> i32;
}

fn main() {
unsafe {
println!("abs(-1) is {}", abs_in_rust(-1));
    }
}

2. 标准库

2.1 std::os::raw 模块

2.2 标准库 std::ffi 模块

CStr

CString

use std::ffi::CString;
use std::os::raw::c_char;

#[no_mangle]
pub extern rust_printer(input: *const c_char) {
let mut hello = String::from("Hello World!");
let c_str_to_print = CString::new(hello).unwrap();
}

• OsString表示传递给操作系统的拥有所有权的字符串。例如，env::var_os()用于查询环境变量，它返回一个Option<OsString>。如果环境变量存在，将获得Some(os_string)，然后可以将其转换为 Rust 字符串。
• OsStr表示传递给操作系统的字符串引用，可以按照与OsString类似的方式将其转换为 UTF-8 编码的 Rust 字符串切片。

参考链接