narust-158 0.3.1

A Rust reimplementation of OpenNARS 1.5.8
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

//! 用于从迭代器中获取其代数均值
//! * 🎯推理器`INF`指令呈现「概要信息」时需要

use crate::global::Float;

/// 对[`usize`]迭代器求均值
/// * ✨此处的`U`支持所有「能[转换](Into)到[`usize`]的类型」
/// * ✨此处的「迭代器」支持像数组那样的[`IntoIterator`]泛类型
pub trait AverageUsize<U: Into<usize>>: IntoIterator<Item = U> + Sized {
    /// 对usize迭代器求均值
    /// * 📝【2024-08-10 13:22:07】关键不能省的代码就在`for`内部：迭代时要同时更新两者
    ///   * ❌【2024-08-10 13:26:35】不能使用[`Iterator::unzip`]
    ///     * ⚠️该函数要返回两个能`collect`到的对象
    ///     * ⚠️但不希望除了俩[`usize`]之外的空间分配
    /// * 📌当迭代器没有元素时，返回[`Float::NAN`]
    fn average_usize(self) -> Float {
        let mut sum: usize = 0;
        let mut count: usize = 0;
        for n in self {
            sum += n.into();
            count += 1;
        }
        sum as Float / count as Float
    }
}

/// 对所有[`usize`]迭代器实现
impl<U: Into<usize>, T> AverageUsize<U> for T where T: IntoIterator<Item = U> {}

/// 对[`Float`]迭代器求均值
/// * ✨此处的`U`支持所有「能[转换](Into)到[`Float`]的类型」
/// * ✨此处的「迭代器」支持像数组那样的[`IntoIterator`]泛类型
pub trait AverageFloat<U: Into<Float>>: IntoIterator<Item = U> + Sized {
    /// 对Float迭代器求均值
    /// * 📝【2024-08-10 13:22:07】关键不能省的代码就在`for`内部：迭代时要同时更新两者
    ///   * ❌【2024-08-10 13:26:35】不能使用[`Iterator::unzip`]
    ///     * ⚠️该函数要返回两个能`collect`到的对象
    ///     * ⚠️但不希望除了俩[`Float`]之外的空间分配
    /// * 📌当迭代器没有元素时，返回[`Float::NAN`]
    fn average_float(self) -> Float {
        let mut sum: Float = 0.0;
        let mut count: usize = 0;
        for n in self {
            sum += n.into();
            count += 1;
        }
        sum as Float / count as Float
    }
}

/// 对所有[`Float`]迭代器实现
impl<U: Into<Float>, T> AverageFloat<U> for T where T: IntoIterator<Item = U> {}