h_math 1.6.1

A Rust library for simple and advanced mathematical computations.
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

// --------------------------------- Algebra ------------------------------


/// Solves the quadratic equation ax^2 + bx + c = 0 and returns the two roots as a tuple (root1, root2).
/// The coefficients a, b, and c can be of any type that can be converted into
/// f64. If the discriminant is negative, the function will panic with a message indicating that no real roots exist.
/// Example usage:
/// let (root1, root2) = h_quadratic_equation(1.0, -3.0, 2.0);
/// The result will be (2.0, 1.0), because the roots of the equation x^2 - 3x + 2 = 0 are x = 2 and x = 1.
/// let (root1, root2) = h_quadratic_equation(1.0, 2.0, 5.0);
/// The function will panic with the message "No real roots exist" because the discriminant (b^2 - 4ac) is negative.
/// Note: The order of the roots in the returned tuple is not guaranteed, so root1 may be the larger or smaller root depending on the coefficients.
pub fn h_quadratic_equation<A,B,C>(a: A, b: B, c: C) -> (f64, f64)
where
    A: Copy + Into<f64>,
    B: Copy + Into<f64>,
    C: Copy + Into<f64>,
{
    let a_f = a.into();
    let b_f = b.into();
    let c_f = c.into();

    let discriminant = b_f * b_f - 4.0 * a_f * c_f;

    if discriminant < 0.0 {
        panic!("No real roots exist");
    }

    let sqrt_discriminant = discriminant.sqrt();
    let root1: f64 = (-b_f + sqrt_discriminant) / (2.0 * a_f);
    let root2: f64 = (-b_f - sqrt_discriminant) / (2.0 * a_f);

    (root1, root2)
}