rssn 0.2.9

A comprehensive scientific computing library for Rust, aiming for feature parity with NumPy and SymPy.
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
116
117
118
119
120
121
122
123
124

//! Handle-based FFI for polynomial operations

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

use crate::symbolic::core::Expr;
use crate::symbolic::polynomial::contains_var;
use crate::symbolic::polynomial::is_polynomial;
use crate::symbolic::polynomial::leading_coefficient;
use crate::symbolic::polynomial::polynomial_degree;
use crate::symbolic::polynomial::polynomial_long_division;

/// Checks if an expression is a polynomial in the given variable (handle-based)
///
/// # Panics
///
/// This function may panic if the FFI input is malformed, null where not expected,
/// or if internal state synchronization fails (e.g., poisoned locks).
#[unsafe(no_mangle)]
pub extern "C" fn polynomial_is_polynomial_handle(
    expr_handle: *const Expr,
    var: *const c_char,
) -> bool {
    let expr = unsafe { &*expr_handle };

    let var_str = unsafe { CStr::from_ptr(var).to_str().unwrap() };

    is_polynomial(expr, var_str)
}

/// Computes the degree of a polynomial (handle-based)
///
/// # Panics
///
/// This function may panic if the FFI input is malformed, null where not expected,
/// or if internal state synchronization fails (e.g., poisoned locks).
#[unsafe(no_mangle)]
pub extern "C" fn polynomial_degree_handle(
    expr_handle: *const Expr,
    var: *const c_char,
) -> i64 {
    let expr = unsafe { &*expr_handle };

    let var_str = unsafe { CStr::from_ptr(var).to_str().unwrap() };

    polynomial_degree(expr, var_str)
}

/// Performs polynomial long division (handle-based)
///
/// # Panics
///
/// This function may panic if the FFI input is malformed, null where not expected,
/// or if internal state synchronization fails (e.g., poisoned locks).
#[unsafe(no_mangle)]
pub extern "C" fn polynomial_long_division_handle(
    dividend_handle: *const Expr,
    divisor_handle: *const Expr,
    var: *const c_char,
    quotient_out: *mut *mut Expr,
    remainder_out: *mut *mut Expr,
) {
    let dividend = unsafe { &*dividend_handle };

    let divisor = unsafe { &*divisor_handle };

    let var_str = unsafe { CStr::from_ptr(var).to_str().unwrap() };

    let (quotient, remainder) = polynomial_long_division(dividend, divisor, var_str);

    unsafe {
        *quotient_out = Box::into_raw(Box::new(quotient));

        *remainder_out = Box::into_raw(Box::new(remainder));
    }
}

/// Finds the leading coefficient of a polynomial (handle-based)
///
/// # Panics
///
/// This function may panic if the FFI input is malformed, null where not expected,
/// or if internal state synchronization fails (e.g., poisoned locks).
#[unsafe(no_mangle)]
pub extern "C" fn polynomial_leading_coefficient_handle(
    expr_handle: *const Expr,
    var: *const c_char,
) -> *mut Expr {
    let expr = unsafe { &*expr_handle };

    let var_str = unsafe { CStr::from_ptr(var).to_str().unwrap() };

    let result = leading_coefficient(expr, var_str);

    Box::into_raw(Box::new(result))
}

/// Checks if an expression contains a variable (handle-based)
///
/// # Panics
///
/// This function may panic if the FFI input is malformed, null where not expected,
/// or if internal state synchronization fails (e.g., poisoned locks).
#[unsafe(no_mangle)]
pub extern "C" fn polynomial_contains_var_handle(
    expr_handle: *const Expr,
    var: *const c_char,
) -> bool {
    let expr = unsafe { &*expr_handle };

    let var_str = unsafe { CStr::from_ptr(var).to_str().unwrap() };

    contains_var(expr, var_str)
}

/// Frees an Expr handle
#[unsafe(no_mangle)]
pub extern "C" fn polynomial_free_expr_handle(expr_handle: *mut Expr) {
    if !expr_handle.is_null() {
        unsafe {
            let _ = Box::from_raw(expr_handle);
        }
    }
}