Външности за чужди функции

Ръждьо предоставя възможност за описване на Външности за чужди функции (ВЧФ)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