polars-core 0.53.0

Core of the Polars DataFrame library
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
125
126
127
128
129
130
131
132
133

use polars_compute::decimal::{
    DEC128_MAX_PREC, dec128_add, dec128_div, dec128_mul, dec128_rescale, dec128_sub,
};

use super::*;
use crate::prelude::arity::broadcast_try_binary_elementwise;

impl Add for &DecimalChunked {
    type Output = PolarsResult<DecimalChunked>;

    fn add(self, rhs: Self) -> Self::Output {
        let left_s = self.scale();
        let right_s = rhs.scale();
        let scale = left_s.max(right_s);
        let prec = DEC128_MAX_PREC;
        let phys = broadcast_try_binary_elementwise(
            self.physical(),
            rhs.physical(),
            |opt_l, opt_r| {
                let (Some(l), Some(r)) = (opt_l, opt_r) else {
                    return PolarsResult::Ok(None);
                };
                let ls = dec128_rescale(l, left_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {l} from scale {left_s} to {scale}")
                })?;
                let rs = dec128_rescale(r, right_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {r} from scale {right_s} to {scale}")
                })?;
                let ret = dec128_add(ls, rs, prec).ok_or_else(
                    || polars_err!(ComputeError: "overflow in decimal addition for {ls} + {rs}"),
                )?;
                Ok(Some(ret))
            },
        );
        Ok(phys?.into_decimal_unchecked(prec, scale))
    }
}

impl Sub for &DecimalChunked {
    type Output = PolarsResult<DecimalChunked>;

    fn sub(self, rhs: Self) -> Self::Output {
        let left_s = self.scale();
        let right_s = rhs.scale();
        let scale = left_s.max(right_s);
        let prec = DEC128_MAX_PREC;
        let phys = broadcast_try_binary_elementwise(
            self.physical(),
            rhs.physical(),
            |opt_l, opt_r| {
                let (Some(l), Some(r)) = (opt_l, opt_r) else {
                    return PolarsResult::Ok(None);
                };
                let ls = dec128_rescale(l, left_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {l} from scale {left_s} to {scale}")
                })?;
                let rs = dec128_rescale(r, right_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {r} from scale {right_s} to {scale}")
                })?;
                let ret = dec128_sub(ls, rs, prec).ok_or_else(
                    || polars_err!(ComputeError: "overflow in decimal subtraction for {ls} - {rs}"),
                )?;
                Ok(Some(ret))
            },
        );
        Ok(phys?.into_decimal_unchecked(prec, scale))
    }
}

impl Mul for &DecimalChunked {
    type Output = PolarsResult<DecimalChunked>;

    fn mul(self, rhs: Self) -> Self::Output {
        let left_s = self.scale();
        let right_s = rhs.scale();
        let scale = left_s.max(right_s);
        let prec = DEC128_MAX_PREC;
        let phys = broadcast_try_binary_elementwise(
            self.physical(),
            rhs.physical(),
            |opt_l, opt_r| {
                let (Some(l), Some(r)) = (opt_l, opt_r) else {
                    return PolarsResult::Ok(None);
                };
                let ls = dec128_rescale(l, left_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {l} from scale {left_s} to {scale}")
                })?;
                let rs = dec128_rescale(r, right_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {r} from scale {right_s} to {scale}")
                })?;
                let ret = dec128_mul(ls, rs, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in decimal multiplication for {ls} * {rs}")
                })?;
                Ok(Some(ret))
            },
        );
        Ok(phys?.into_decimal_unchecked(prec, scale))
    }
}

impl Div for &DecimalChunked {
    type Output = PolarsResult<DecimalChunked>;

    fn div(self, rhs: Self) -> Self::Output {
        let left_s = self.scale();
        let right_s = rhs.scale();
        let scale = left_s.max(right_s);
        let prec = DEC128_MAX_PREC;
        let phys = broadcast_try_binary_elementwise(
            self.physical(),
            rhs.physical(),
            |opt_l, opt_r| {
                let (Some(l), Some(r)) = (opt_l, opt_r) else {
                    return PolarsResult::Ok(None);
                };
                if r == 0 {
                    polars_bail!(ComputeError: "division by zero Decimal");
                }
                let ls = dec128_rescale(l, left_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {l} from scale {left_s} to {scale}")
                })?;
                let rs = dec128_rescale(r, right_s, prec, scale).ok_or_else(|| {
                    polars_err!(ComputeError: "overflow in Decimal cast for {r} from scale {right_s} to {scale}")
                })?;
                let ret = dec128_div(ls, rs, prec, scale).ok_or_else(
                    || polars_err!(ComputeError: "overflow in decimal division for {ls} / {rs}"),
                )?;
                Ok(Some(ret))
            },
        );
        Ok(phys?.into_decimal_unchecked(prec, scale))
    }
}