Външности за чужди функции
Ръждьо предоставя възможност за описване на Външности за чужди функции (ВЧФ)1 за
библиотеки, написани на езика C. Чуждите функции трябва да се обявят в именуван външен
блок extern2, означен с атрибут #[link], който съдържа името на
чуждата библиотека.
use std::fmt;
// Този външен блок се свързва с библиотеката libm.
#[link(name = "m")]
extern {
// Това е чужда функция, която изчислява корен квадратен от комплексно
// число с единична точност.
fn csqrtf(z: Complex) -> Complex;
fn ccosf(z: Complex) -> Complex;
}
// Тъй като извикването на чужди функции се смята за опасно, обичайно се пишат
// обгръщащи функции, които извикват чуждите.
fn cos(z: Complex) -> Complex {
unsafe { ccosf(z) }
}
fn main() {
// z = -1 + 0i
let z = Complex { re: -1., im: 0. };
// Извикването на чужда функция е опасно действие.
let z_sqrt = unsafe { csqrtf(z) };
println!("Корен квадратен от {:?} е {:?}", z, z_sqrt);
// Извикваме безопасно ППВ, обгръщащо опасно действие.
println!("cos({:?}) = {:?}", z, cos(z));
}
// Най-малко въплъщение на комплексни числа с единична точност.
#[repr(C)]
#[derive(Clone, Copy)]
struct Complex {
re: f32,
im: f32,
}
impl fmt::Debug for Complex {
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
if self.im < 0. {
write!(f, "{}-{}i", self.re, -self.im)
} else {
write!(f, "{}+{}i", self.re, self.im)
}
}
}
Б. пр.
1
Външност за чужди функции (ВЧФ) – Foreign function interface (FFI). Приложна програмна външност (ППВ) – Application programming interface (API)
2
външен – extern